PGLE gate, LINK_EXEC function
The LINK_EXEC function of the PGLE gate is used to link to a program in response to a user EXEC CICS LINK command.
Input Parameters
- PROGRAM_NAME
- is the name of the program resource to be defined.
- APPLICATION_ID
- Optional Parameter
- is the name of the application whose entry point program is being linked to.
- APPL_MAJOR_VER
- Optional Parameter
- is the major version number of the application whose entry point program is being linked to.
- APPL_MICRO_VER
- Optional Parameter
- is the micro version number of the application whose entry point program is being linked to.
- APPL_MINOR_VER
- Optional Parameter
- is the minor version number of the application whose entry point program is being linked to.
- CHANNEL
- Optional Parameter
- is the optional channel to be made available to the linked program.
- COMMAREA
- Optional Parameter
- is the optional communications area to be made available to the linked program.
- FORCE_LOCAL
- Optional Parameter
- indicates whether the program must execute locally.
- Values for the parameter are:
- NO
- YES
- HANDLE_ABEND_PGM
- Optional Parameter
- defines whether or not the program is to run as an abend handler program.
- Values for the parameter are:
- NO
- YES
- INPUTMSG
- Optional Parameter
- is a data area to be supplied to the linked program on its first execution of an EXEC CICS RECEIVE command.
- PLATFORM_ID
- Optional Parameter
- is the name of the platform on which the application is installed, whose entry point program is being linked to.
- SYNCONRETURN
- Optional Parameter
- defines whether or not a syncpoint is to be taken on return from the linked program.
- Values for the parameter are:
- NO
- YES
- SYSEIB_REQUEST
- Optional Parameter
- Specifies whether the EXEC CICS LINK had the SYSEIB translator option specified.
- Values for the parameter are:
- NO
- YES
Output Parameters
- REASON
- The following values are returned when RESPONSE is EXCEPTION:
- AUTOINSTALL_FAILED
- AUTOINSTALL_INVALID_DATA
- AUTOINSTALL_MODEL_NOT_DEF
- AUTOINSTALL_URM_FAILED
- AUTOSTART_DISABLED
- DESTRUCTIVE_OVERLAP
- DYNAMIC_PGM
- INVALID_CHANNEL_NAME
- INVALID_COMMAREA_ADDR
- INVALID_COMMAREA_LEN
- INVALID_INPUTMSG_LEN
- INVALID_KEYWORDS
- INVALID_TERMINAL_TYPE
- JVM_PROFILE_NOT_FOUND
- JVM_PROFILE_NOT_VALID
- JVMPOOL_DISABLED
- NO_TERMINAL
- NOT_INITIALIZED
- PROGRAM_NOT_AUTHORISED
- PROGRAM_NOT_DEFINED
- PROGRAM_NOT_ENABLED
- PROGRAM_NOT_LOADABLE
- REMOTE_PROGRAM
- SECOND_H8_PROGRAM
- SECOND_JVM_PROGRAM
- SYSTEM_PROPERTIES_NOT_FND
- TRANSACTION_ABEND
- USER_CLASS_NOT_FOUND
- ABEND_CODE
- is the four-character abend code to be issued if CICS drives the system default, which is to abend the transaction.
- REMOTE_PROGRAM_NAME
- is 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
- is the name of a remote CICS region if you want CICS to ship a distributed program link (DPL) request to another CICS region.
- REMOTE_TRANID
- is the name of the transaction you want the remote CICS to attach, and under which it is to run the remote program.
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.