The start_browse_program call, Response and reason values for set_program – IBM SC33-1683-02 User Manual

Page 378

Advertising
background image

RESPONSE and REASON values for SET_PROGRAM:

RESPONSE

REASON

OK

None

EXCEPTION

CEDF_STATUS_NOT_FOR_MAPSET
CEDF_STATUS_NOT_FOR_PTNSET
CEDF_STATUS_NOT_FOR_REMOTE
EXEC_KEY_NOT_FOR_MAPSET
EXEC_KEY_NOT_FOR_PTNSET
EXEC_KEY_NOT_FOR_REMOTE
EXEC_SET_NOT_FOR_MAPSET
EXEC_SET_NOT_FOR_PTNSET
EXEC_SET_NOT_FOR_REMOTE
PROGRAM_NOT_DEFINED_TO_LD
PROGRAM_NOT_DEFINED_TO_PG

DISASTER

ABEND
CATALOG_ERROR
CATALOG_NOT_OPERATIONAL
LOCK_ERROR

INVALID

INVALID_MODE_COMBINATION
INVALID_PROGRAM_NAME
INVALID_PROGRAM_TOKEN
INVALID_TYPE_ATTRIB_COMBIN

KERNERROR

None

PURGED

None

The START_BROWSE_PROGRAM call

START_BROWSE_PROGRAM returns a token that enables you to begin browsing
through program definitions, optionally starting at the definition of a specified
program.

START_BROWSE_PROGRAM

DFHPGISX [CALL,]

[CLEAR,]

[IN,

FUNCTION(START_BROWSE_PROGRAM),

[PROGRAM_NAME(name8 | string | 'string'),]]

[OUT,

BROWSE_TOKEN(name4)

RESPONSE(name1 | *),

REASON(name1 | *)]

BROWSE_TOKEN(name4)

returns a token to be used on a GET_NEXT_PROGRAM call, to initiate a
sequential browse of program definitions.

name4

The name of a location to receive a 4-byte token.

PROGRAM_NAME(name8 | string | 'string')

specifies the name of the program whose definition you want to look at first.
The browsing sequence is alphabetical. If there is no program with the specified
name, CICS returns a token for the next definition in the alphabetic sequence. If
you do not specify a program, CICS returns a token for the first definition.

name8

The name of a location containing an 8-byte program name.

program management functions

346

CICS TS for OS/390: CICS Customization Guide

Advertising