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.


dfhs3_PGLElink_exec.html | Timestamp icon Last updated: Monday, 5 June 2017