CSLRMPRT: process terminate

You can issue the CSLRMPRT request to terminate an IMSplex-wide process. Any client that is participating in the process can issue a CSLRMPRT FUNC= TERMINATE request to terminate the process.

This request is supported in assembler language.

CSLRMPRT syntax

The syntax for the CSLRMPRT request follows.

DSECT syntax

Use the DSECT function of a CSLRMPRT request to include equate (EQU) statements in your program for the length of the CSLRMPRT parameter list.

Read syntax diagramSkip visual syntax diagramCSLRMPRT FUNC=DSECT

TERMINATE syntax

Use the TERMINATE function of a CSLRMPRT request to terminate an IMSplex-wide process.

Figure 0.
Read syntax diagramSkip visual syntax diagramCSLRMPRTFUNC=TERMINATEOPTWORD1= processtermoptionsPARM= parmPRCNAME= processnamePRCTOKEN= processtokenPRCTYPE= processtypeUOWTOKEN= uowtokenRETNAME= returnnameRETTOKEN= returntokenRETCODE= returncodeRSNCODE= reasoncodeSCITOKEN= scitoken

CSLRMPRT parameters

OPTWORD1=symbol
OPTWORD1=(r2-r12)

(Optional) - Specifies a 4-byte field containing the process terminate options. CSLRMPRT FUNC=DSECT maps the process terminate options.

The following options can be set in OPTWORD1:
  • X'80000000': Force process to terminate
  • X'40000000': Suppress process to terminate error messages
PARM=symbol
PARM=(r2-r12)
(Required) - Specifies the CSLRMPRT parameter list. The length of the parameter list must be equal to the parameter list length EQU value defined by RPRT_PARMLN.
PRCNAME=symbol
PRCNAME=(r2-r12)
(Required) - Specifies an 8-byte field containing the process name. The process name is client defined and has no meaning to RM. RM uses the process name and the process type to ensure that only one instance of a process of a particular process type is in progress at one time.
PRCTOKEN=symbol
PRCTOKEN=(r2-r12)
(Required) - Specifies a 16-byte field that contains the process token that uniquely identifies the process. This token was returned on a successful CSLRMPRI FUNC=INITIATE request.

If the IMSplex is defined with a resource structure, the process token is zero.

PRCTYPE=symbol
PRCTYPE=(r2-r12)
(Required) - Specifies a 1-byte client-defined process type. Only one process of a particular type can be in progress at any one time. The process type can be 1 through 255.
RETCODE=symbol
RETCODE=(r2-r12)
(Required) - Specifies a 4-byte field to receive the return code on output. SCI return codes are defined in CSLSRR. RM does not return a response to CSLRMPRT.
RETNAME=symbol
RETNAME=(r2-r12)
(Optional) - Specifies an 8-byte field to receive the name of the RM address space to which SCI sent the process terminate request.
RETTOKEN=symbol
RETTOKEN=(r2-r12)
(Optional) - Specifies a 16-byte field to receive the SCI token of the RM address space to which SCI sent the process terminate request.
RSNCODE=symbol
RSNCODE=(r2-r12)
(Required) - Specifies a 4-byte field to receive the reason code on output. SCI reason codes are defined in CSLSRR. RM does not return a response to the CSLRMPRT request.
SCITOKEN=symbol
SCITOKEN=(r2-r12)
(Required) - Specifies a 16-byte field containing the SCI token. This token uniquely identifies this connection to SCI. The SCI token was returned by a successful CSLSCREG FUNC=REGISTER request.
UOWTOKEN=symbol
UOWTOKEN=(r2-r12)
(Required) - Specifies a 16-byte field containing the unit of work token. The UOW token uniquely identifies an instance of this process and ties all of the process steps together. The UOW token must match the UOW token specified on the CSLRMPRI FUNC=INITIATE request. The UOW token is client-defined and has no meaning to RM.

CSLRMPRT return and reason codes

CSLRMPRT is sent to the target client address space using the SCI message protocol. All return and reason codes that are applicable to the CSLSCMSG request can be returned on a CSLRMPRT request. CSLRMPRT does not issue any additional return and reason codes.