PGIS gate, GET_NEXT_PROGRAM function
The GET_NEXT_PROGRAM function of the PGIS gate is used to get the next program definition to be browsed.
Input Parameters
- APPLICATION_NAME
- Optional parameter
- The 64-character buffer to receive the name of the application associated with the program.
- BROWSE_TOKEN
- A browse token that references the next container in the container pool that is being browsed.
- JVM_CLASS
- Optional Parameter
- The name of the main class in a Java™ program that is running under the control of a Java Virtual Machine (JVM).
- OPERATION_NAME
- Optional parameter
- The 64-character buffer to receive the name of the operation associated with the program.
- PLATFORM_NAME
- Optional parameter
- The 64-character buffer to receive the name of the platform associated with the program.
- RESOURCE_SIGNATURE
- Optional parameter
- A buffer to receive the PROGRAM resource signature.
Output Parameters
- REASON
- The following values are returned when RESPONSE is DISASTER:
- ABEND
- LOCK_ERROR
- The following values are returned when RESPONSE is EXCEPTION:
- END_LIST
- INVALID_BROWSE_TOKEN
- PROGRAM_NOT_DEFINED_TO_LD
- The values for the parameter are as follows:
- NO_REASON
- PROGRAM_NAME
- The name of the program.
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
- ACCESS
- Optional Parameter
- The type of access for the program.
- Values for the parameter are as follows:
- CICS
- NONE
- READ_ONLY
- USER
- APIST
- Optional Parameter
- Indicates whether the program is restricted to use of only the CICS® permitted application programming interfaces.
- Values for the parameter are as follows:
- CICSAPI
- OPENAPI
- AVAIL_STATUS
- Optional Parameter
- Indicates whether the program can be used (ENABLED) or not (DISABLED).
- Values for the parameter are as follows:
- DISABLED
- ENABLED
- CEDF_STATUS
- Optional Parameter
- Indicates whether the EDF diagnostic screens are displayed when the program is running under the control of the execution diagnostic facility (EDF).
- Values for the parameter are as follows:
- CEDF
- NOCEDF
- NOT_APPLIC
- CONCURRENCY
- Optional Parameter
- Indicates whether the program is threadsafe or only quasi-reentrant.
- Values for the parameter are as follows:
- QUASIRENT
- THREADSAFE
- DATA_LOCATION
- Optional Parameter
- Indicates whether the program can handle only 24-bit addresses (data located below the 16 MB line), or can also handle 31-bit addresses (data located above or below the 16 MB line). The DATALOCATION options are independent from the addressing mode of the link-edited program.
- Values for the parameter are as follows:
- ANY
- BELOW
- NOT_APPLIC
- DYNAMIC_STATUS
- Optional Parameter
- Indicates whether a request to LINK to the program can be dynamically routed.
- Values for the parameter are as follows:
- DYNAMIC
- NOTDYNAMIC
- ENTRY_POINT
- Optional Parameter
- The token that defines the entry point of the program.
- EXECUTION_KEY
- Optional Parameter
- The key in which CICS gives control to the program, and that determines whether the program can modify CICS-key storage. If the program is link-edited with the RENT attribute and the RMODE(ANY) mode statement, CICS loads the program into the extended read-only DSA (ERDSA), regardless of the EXECKEY option. The ERDSA is allocated from read-only extended storage only if RENTPGM=PROTECT is specified as a system initialization parameter.
- Values for the parameter are as follows:
- CICS
- NOT_APPLIC
- USER
- EXECUTION_SET
- Optional Parameter
- Indicates whether CICS can link to and run the program as if it were running in a remote CICS region (with or without the API restrictions of a DPL program).
- Values for the parameter are as follows:
- DPLSUBSET
- FULLAPI
- NOT_APPLIC
- HOLD_STATUS
- Optional Parameter
- The hold status of the program (that is, for how long the program is to be loaded).
- Values for the parameter are as follows:
- CICS_LIFE
- NOT_APPLIC
- TASK_LIFE
- INSTALL_TYPE
- Optional Parameter
- The method used to install the PROGRAM resource definition.
- Values for the parameter are as follows:
- AUTO
- CATALOG
- GROUPLIST
- MANUAL
- RDO
- SYSAUTO
- JVM
- Optional Parameter
- Indicates whether the program is run under the control of a Java Virtual Machine (JVM).
- Values for the parameter are as follows:
- NO
- YES
- JVM_PROFILE
- Optional Parameter
- The name of the JVM profile. The named profile provides the attributes of the JVM that are needed to run the program.
- JVMPROGRAM_USE_COUNT
- Optional Parameter
- For Java programs that run under the control of a JVM, the number of times the program has been used.
- LANGUAGE_DEDUCED
- Optional Parameter
- The language deduced by CICS for the program.
- Values for the parameter are as follows:
- ASSEMBLER
- COBOL
- COBOL2
- C370
- JAVA
- LE370
- NOT_APPLIC
- NOT_DEDUCED
- PLI
- LANGUAGE_DEFINED
- Optional Parameter
- The language defined for the program.
- Values for the parameter are as follows:
- ASSEMBLER
- COBOL
- C370
- LE370
- NOT_APPLIC
- NOT_DEFINED
- PLI
- LANGUAGE_TOKEN
- Optional Parameter
- A token that represents the AP domain language block for the program.
- LIBRARY
- Optional Parameter
- The name of the LIBRARY concatenation from which the program was loaded.
- LIBRARYDSN
- Optional Parameter
- The name of the data set in the LIBRARY concatenation from which the program was loaded.
- LOAD_POINT
- Optional Parameter
- The load point address of the program, as returned by the loader domain on the ACQUIRE_PROGRAM call.
- LOAD_STATUS
- Optional Parameter
- The load status of the program (that is, whether or not the program can be loaded).
- Values for the parameter are as follows:
- LOADABLE
- NOT_APPLIC
- NOT_LOADABLE
- NOT_LOADED
- LOCATION
- Optional Parameter
- Indicates where the program resides.
- Values for the parameter are as follows:
- CDSA
- ECDSA
- ELPA
- ERDSA
- ESDSA
- LPA
- NONE
- RDSA
- SDSA
- MAJOR_VERSION
- Optional parameter
- The fullword binary value that is the major version of the application associated with the program.
- MINOR_VERSION
- Optional parameter
- The fullword binary value that is the minor version of the application associated with the program.
- MICRO_VERSION
- Optional parameter
- The fullword binary value that is the micro version of the application associated with the program.
- MODULE_TYPE
- Optional Parameter
- The type of program resource to be defined.
- Values for the parameter are as follows:
- MAPSET
- PARTITIONSET
- PROGRAM
- NEW_PROGRAM_TOKEN
- Optional Parameter
- The token assigned to program.
- PROGRAM_ATTRIBUTE
- Optional Parameter
- Indicates the residence status of the program, and when the storage for this program is released.
- Values for the parameter are as follows:
- RELOAD
- RESIDENT
- REUSABLE
- TEST
- TRANSIENT
- PROGRAM_LENGTH
- Optional Parameter
- The length of the program, as returned by the loader domain on the ACQUIRE_PROGRAM call.
- PROGRAM_TYPE
- Optional Parameter
- The type of program.
- Values for the parameter are as follows:
- NOT_APPLIC
- PRIVATE
- SHARED
- TYPE_ANY
- PROGRAM_USAGE
- Optional Parameter
- Indicates whether the program is used as a CICS nucleus program, or as a user application program.
- Values for the parameter are as follows:
- APPLICATION
- NUCLEUS
- PROGRAM_USE_COUNT
- Optional Parameter
- The number of times that the program has been used.
- PROGRAM_USER_COUNT
- Optional Parameter
- The number of different users that have invoked the program.
- REMOTE_DEFINITION
- Optional Parameter
- Indicates whether the program is defined as remote or local.
- Values for the parameter are as follows:
- LOCAL
- REMOTE
- REMOTE_PROGID
- Optional Parameter
- The name by which the program is known in the remote CICS region. If you specify REMOTE_SYSID and omit REMOTE_PROGID, the REMOTE_PROGID parameter defaults to the same name as the local name (that is, the PROGRAM_NAME value.
- REMOTE_SYSID
- Optional Parameter
- The name of a remote CICS region if CICS can ship a distributed program link (DPL) request to another CICS region.
- REMOTE_TRANID
- Optional Parameter
- The name of the transaction the remote CICS can attach to, and under which it can run the remote program.
- RUNTIME_ENVIRONMENT
- Optional Parameter
- Indicates the runtime environment used to run this program.
- Values for the parameter are as follows:
- JVM_RUNTIME
- LE370_RUNTIME
- NON_LE370_RUNTIME
- NOT_APPLIC
- UNKNOWN_RUNTIME
- XPLINK_RUNTIME
- SPECIFIED_AMODE
- Optional Parameter
- The addressing mode of the program.
- Values for the parameter are as follows:
- AMODE_ANY
- AMODE_NOT_SPECIFIED
- 24
- 31
- 64
- SPECIFIED_RMODE
- Optional Parameter
- The residence mode of the program.
- Values for the parameter are as follows:
- RMODE_ANY
- RMODE_NOT_SPECIFIED
- 24