The GET_NEXT_PROGRAM call
Use GET_NEXT_PROGRAM to inquire on the next program definition during a browse sequence that is initiated by START_BROWSE_PROGRAM. The browsing sequence is alphabetical. The end of the alphabetical list of definitions is indicated by an END_LIST exception response.
GET_NEXT_PROGRAM
DFHPGISX [CALL,]
[CLEAR,]
[IN,
FUNCTION(GET_NEXT_PROGRAM),
BROWSE_TOKEN(name4),]
[OUT,
PROGRAM_NAME(name8),
[ACCESS(CICS|NONE|READ_ONLY|USER),]
[AVAIL_STATUS(DISABLED|ENABLED),]
[CEDF_STATUS(CEDF|NOCEDF|NOT_APPLIC),]
[DATA_LOCATION(ANY|BELOW|NOT_APPLIC),]
[ENTRY_POINT(name4),]
[EXECUTION_KEY(CICS|NOT_APPLIC|USER),]
[EXECUTION_SET(DPLSUBSET|FULLAPI|NOT_APPLIC),]
[HOLD_STATUS(CICS_LIFE|NOT_APPLIC|TASK_LIFE),]
[INSTALL_TYPE(AUTO|CATALOG|GROUPLIST|MANUAL|RDO|SYSAUTO),]
[LANGUAGE_DEDUCED(ASSEMBLER|C370|COBOL|
COBOL2|LE370|NOT_APPLIC|NOT_DEDUCED|PLI),]
[LANGUAGE_DEFINED(ASSEMBLER|C370|COBOL|
LE370|NOT_APPLIC|NOT_DEFINED|PLI),]
[LOAD_POINT(name4),]
[LOAD_STATUS(LOADABLE|NOT_APPLIC|NOT_LOADABLE|NOT_LOADED),]
[LOCATION(CDSA|ECDSA|ELPA|ERDSA|ESDSA|LPA|NONE|RDSA|SDSA),]
[MODULE_TYPE(MAPSET|PARTITIONSET|PROGRAM),]
[NEW_PROGRAM_TOKEN(name4),]
[PROGRAM_ATTRIBUTE(RELOAD|RESIDENT|REUSABLE|TRANSIENT),]
[PROGRAM_LENGTH(name4),]
[PROGRAM_TYPE(NOT_APPLIC|PRIVATE|SHARED|TYPE_ANY),]
[PROGRAM_USAGE(APPLICATION|NUCLEUS),]
[PROGRAM_USE_COUNT(name4),]
[PROGRAM_USER_COUNT(name4),]
[REMOTE_DEFINITION(LOCAL|REMOTE),]
[REMOTE_PROGID(name8),]
[REMOTE_SYSID(name4),]
[REMOTE_TRANID(name4),]
[SPECIFIED_AMODE(24|31|AMODE_ANY|AMODE_NOT_SPECIFIED|64),]
[SPECIFIED_RMODE(24|RMODE_ANY|RMODE_NOT_SPECIFIED),]
RESPONSE(name1 | *),
REASON(name1 | *)]
This command is threadsafe.
Note: The
options not described in the following list are identical to the equivalent
options of the INQUIRE_PROGRAM call. See The INQUIRE_PROGRAM call.
- BROWSE_TOKEN(name4)
- Specifies a token that identifies the definition to be browsed.
This can be 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_PROGRAM call).
- name4
- The name of a location that contains a 4-byte token.
- 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 |