NEW_PROGRAM_TOKEN(name4)
returns a token that identifies the next definition in the browse sequence. You
can use it in the BROWSE_TOKEN field of your next GET_NEXT_PROGRAM
call (or END_BROWSE_PROGRAM call, if you want to end the sequence). You
can also use it in the PROGRAM_TOKEN field of INQUIRE_PROGRAM and
SET_PROGRAM calls.
name4
The name of a location to receive a 4-byte token that identifies the next
program definition.
RESPONSE and REASON values for GET_NEXT_PROGRAM:
RESPONSE REASON
OK None
EXCEPTION END_LIST
INVALID_BROWSE_TOKEN
PROGRAM_NOT_DEFINED_TO_LD
DISASTER ABEND
LOCK_ERROR
INVALID None
KERNERROR None
PURGED None
The END_BROWSE_PROGRAM call
END_BROWSE_PROGRAM allows you to end a browse of program definitions
initiated by START_BROWSE_PROGRAM.
END_BROWSE_PROGRAM
DFHPGISX [CALL,]
[CLEAR,]
[IN,
FUNCTION(END_BROWSE_PROGRAM),
BROWSE_TOKEN(name4),]
[OUT,
RESPONSE(name1 | *),
REASON(name1 | *)]
This command is threadsafe.
BROWSE_TOKEN(name4)
specifies either the token returned in the NEW_PROGRAM_TOKEN field of the
last GET_NEXT_PROGRAM call, or that in the BROWSE_TOKEN field of the
START_BROWSE_PROGRAM call (this token is updated after every
GET_NEXT_PROGRAM call).
RESPONSE and REASON values for END_BROWSE_PROGRAM:
RESPONSE REASON
OK None
EXCEPTION INVALID_BROWSE_TOKEN
DISASTER ABEND
LOCK_ERROR
INVALID None
KERNERROR None
PURGED None
Chapter 3. The user exit programming interface (XPI) 381