The IKJURPS Parameter List

Use the IKJURPS parameter list to communicate with:

The unauthorized control layer; you tell the unauthorized control layer the name of the unauthorized resource processor to invoke.
The unauthorized resource processor; you can give the unauthorized resource processor installation-defined data so the unauthorized resource processor can interrogate the data.

Figure 1 describes the parameter list passed between the application and the TSO/E IKJURPS service. You must first create the IKJURPS parameter list and place its address into general register 1. Be certain:

To turn on the high-order bit in the address of the last parameter to indicate the end of the parameter list
All other high-order bits for all other parameters are set off.

Figure 1. Parameter List for IKJURPS

The application uses register 1 to point to a list of addresses, of which each of these addresses points to a specific parameter. The parameters are:

Parameter 1 (input)

A fullword containing a pointer to an environment control table (ECT). The IKJURPS service uses this ECT when it requires the use of the TSO/E I/O service routines; for example, when IKJURPS issues a message.

Note that this ECT might not be the same ECT that the unauthorized resource processor receives in the Command Processor parameter list (CPPL) passed to it. For more information, refer to the discussion of the CPPL on entry to the resource processor and Receiving Control in an unauthorized resource processor.

Parameter 2 (input)

An 8-byte field containing the entry point name of the unauthorized resource processor. The unauthorized control layer uses this as the name of the module it is to invoke.

Parameter 3 (input)

A fullword containing a token passed to the unauthorized resource processor. You can use the token to communicate with the resource processor.

Parameter 4 (output)

A fullword containing a return code from the unauthorized resource processor. The invoker of the IKJURPS service can use this return code as a more detailed diagnostic; for example, if the unauthorized resource processor does not complete processing successfully.

Parameter 5 (output)

A fullword containing a reason code from the unauthorized resource processor. The invoker of the IKJURPS service can use this reason code as a more detailed diagnostic; for example, if the unauthorized resource processor does not complete processing successfully.

Parameter 6 (output)

A fullword containing an error code. The IKJURPS service sets the error code to indicate detailed diagnostics regarding completion of the IKJURPS service.

All subsequent parameters are optional. If you do not code any of the following parameters, the high-order bit of the address of this parameter must be on to indicate the end of the parameter list.

Parameter 7 (output) - optional

A fullword containing a return code. The IKJURPS service sets the return code in this parameter and register 15 when IKJURPS completes. The IKJURPS service sets this return code to indicate the type of error, if any. For example, an error due to a parameter error or an environment error. All subsequent parameters are optional. If you do not code any of the following parameters, the high-order bit of the address of this parameter must be on to indicate the end of the parameter list.

Parameter 8 (output) - optional

A fullword containing an abend code in the event of abnormal termination. The IKJURPS service returns the abend code as defined by the SWAABCC field of the SDWA. All subsequent parameters are optional. If you do not code any of the following parameters, the high-order bit of the address of this parameter must be on to indicate the end of the parameter list.

Parameter 9 (output) - optional

A fullword containing an abend reason code in the event of an abnormal termination. The IKJURPS service returns the abend reason code as defined by the SDWAHRC field of the SDWA. All subsequent parameters are optional. If you do not code any of the following parameters, the high-order bit of the address of this parameter must be on to indicate the end of the parameter list.

Parameter 10 (input) - optional

A fullword containing an indicator to the IKJURPS service that specifies whether to issue error messages. Set this parameter as follows:

X'00000000': The IKJURPS service is not to issue error messages. This is the default if the parameter is not specified.
X'00000001': The IKJURPS service is to issue (if appropriate).

If you code this parameter, the high-order bit of the address of this parameter must be on to indicate the end of the parameter list.