Response and reason values for get_next_program, The end_browse_program call, Response and reason values for end_browse_program – IBM SC34-6814-04 User Manual

Page 403

Advertising
background image

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

Advertising