Customizing the Billing Reports › How Customization Works › Customizing the GSISVCX Module

Customizing the GSISVCX Module

GSISVCX, the CA IDMS Tools version of the assembler language module IDMSSVCX is designed to create a 40-position extension to the CA IDMS External Request Element control block (ERE). The type of data that is placed into these 40 positions by the module depends, in part, on whether the run-unit being processed is identified by CA IDMS as BATCH or CICS.

For any type of run-unit--the JOBNAME, the run-unit start date and time, and the step start time are moved into the ERE by GSISVCX.

For BATCH run-units--up to 16 bytes of information contained in the account field of the job card are moved into the ERE by GSISVCX.

For CICS run-units--the transaction ID, terminal ID, and operator ID are moved into the ERE by GSISVCX. You will need to customize this module if your installation already uses a version of IDMSSVCX and that function must be retained for continued use: if your account number is not in the first field of the z/OS JOB ACCT parameter; if your installation uses a TP monitor other than CICS; or if the data moved into the ERE is not sufficient for your billing system requirements.

To customize GSISVCX, your systems programmer must make the desired changes to the source code. See the CA IDMS Installation and Maintenance Guide.

When altering the source code for GSISVCX, follow these guidelines:

• The ERE may be defined as any length between 40 and 32767 but only the first 40 positions will be written by CA IDMS to the Task Statistics Record.
• All CA IDMS Log Analyzer Billing Report functions depend upon the data in the ERE. This is especially true of the ERE fields containing the ONLINE/BATCH designation, and the ACCOUNT/TRANS-ID, TERM-ID, OPER-ID data. If the position, size, or format of these data fields is altered, it will have serious impact on your ability to select log records for inclusion in the Billing Reports or Billing File. Specifically, if the ONLINE/BATCH indicator is moved or altered, you will no longer be able to specify RUTYPE=ONLINE or RUTYPE=BATCH on any request for Billing Reports or Billing Files. See Parameters. If ACCOUNT/TRANS-ID, TERM-ID, or OPER-ID are moved or altered, you will no longer be able to use the NAME parameter for any Billing request. Finally, if any of these fields are moved or altered, the USLBILX and USLRPT5 modules will have to be modified to accept the revised format of the ERE. See External Request Element Extension for the ERE descriptions.
• After the GSISVCX source code is modified, the resulting load module must be identified to the CA IDMS SVC. See the CA IDMS Installation and Maintenance Guide for detailed information.