Previous Topic: Changes to Library NamesNext Topic: Obsolete Members


Changes to USERMODS

CA 1® Tape Management Release 12.6.00 is enhanced to simplify product installation and customization. 

The USERMODs to customize TMSKEYAB and TMSSECAB are replaced with new members in the CTAPOPTN parameter library (previously known as PPOPTION). The remaining USERMODs are provided to control user exit source. These USERMODs have been restructured and renamed to match the name of the exit they modify. For example, in Release 11.5 the TMSUX2A exit was installed by customizing members CL05201 and CL05201S to form the USERMOD CL05201 for TMSUX2A. In Release 12.6.00, user exit TMSUX2A is renamed to TMSXITA and the SMP/E JCL to customize TMSXITA is provided in the CTAPJCL library. A full sample of the source code for each exit is provided in CTAPSAMP. 

Use the following process to customize TMSXITA:

  1. Copy the source from CTAPSAMP to the appropriate place in member TMSXITA of CTAPSRC.
  2. Change the source to meet your installation requirements. Follow the instructions provided in job TMSXITA.
  3. Submit job TMSXITA job CTAPJCL to apply the changes to CTAPLINK (or IBM libraries in some cases) using SMP/E.
  4. Specify the name of the exits to call in member TMOOPT00 of CTAPOPTN. For TMSXITA, change the following:
    XITA   NONE
    

    to

    XITA   TMSXITA  (or the name you selected for TMSXITA, such as SYS1UXA)
    

We recommend that you review the reason for your use of each user exit. In some cases, functionality previously done through a user exit has been incorporated into the product itself. For example, Abend Retention was controlled through a global option (ABE) or a user exit. Abend Retention is now assigned on a file name or jobname basis using the Retention Data Set (RDS).

We recommend that you review the following table to determine the impact these changes may have to your installation:

Original Name

New Name

Elements

Description

CL05200

Obsolete

n/a

Replaced with options CONAME, COADDR, and COCITY.

CL05201

TMSXITA

TMSXITA (TMSUX2A)

Used to automatically bypass CA 1 real-time tape tracking without using EXPDT=98000 in the JCL. This exit is invoked at every tape OPEN, CLOSE and EOV request, prior to the CA 1 non-label volser WTOR, after the non-label WTOR, and from the CA 1 label editor routine.

Update option XITA in TMOOPT00 to call this exit.

CL05202

TMSXITB

TMSXITB (TMSUX2B)

Establishes retention other than the assigned Abend Default Retention specified in the CA 1 option member TMOOPTxx (parameter ABE). This exit is optional because unique Abend retention values can be specified in the Retention Data Set (RDS) rules.

Update option XITB in TMOOPT00 for this exit to be called.

CL05203

TMSXITJ

TMSXITJ (TMSUX2J)

Captures accounting data specified in job or step statements in the JCL.

Update option XITJ in TMOOPT00 to call this exit.

CL05204

TMSXITC

TMSXITC (TMSUX2C)

Customizes the accounting information copied to the TMC records for secondary volumes.

Update option XITC in TMOOPT00 to call this exit.

CL05205

TMSXITE

TMSXITE (TMSUX2E)

Converts internal numeric volume serial numbers to an external alphanumeric value. Use is not required if the TMSXTEND utility has been used to format the TMC.

Update option XITE in TMOOPT00 to call this exit.

CL05206

TMSXITL

TMSXITL (TMSUX2L)

Specifically designates which tapes have external gummed labels created by TMSLBLPR.

Update option XITL in TMOOPT00 to call this exit.

CL05207

TMSXITS

TMSXITS (TMSUX2S)

Used with the CA 1 external security interface. If used to supply a default CA 1 password; that process is now available as an option in CTAPOPTN member TMOOPT00.

Update option XITS in TMOOPT00 to call this exit.

CL05209

TMSXITU

TMSXITU (TMSUX2U)

Converts external alphanumeric volume serial numbers to an internal numeric value. Use is not required if the TMSXTEND utility formatted the TMC or if the TMSVOLDF USERMOD is used.

Update option XITU in TMOOPT00 to call this exit.

CL05210

Obsolete

n/a

Changes the keyword tables.

CL05211

TMOSEC00

n/a

Use CTAPOPTN member TMOSEC00 to change the passwords (profiles) used by the ISPF interface to CA 1.

CL05212

CTSJUEDM

CTSUXEDM

Specifically defines data sets controlled by an External Data Manager (EDM).

CL05216

TMOKEY00

TMMUSER (optional)

Use CTAPOPTN member TMOKEY00 to define user accounting fields in the TMC volume record.

CL05219 / SMP3480

CTSJUMSG

IGXMSGEX / CTSMSGLC

Displays the first eight characters of the scratch pool name on the 3480/3490 message display.

CL05220

Obsolete

n/a

Converts Version 4.x TMC to 5.2 format.

CL05222

TMSXITCO

TMSXITCO (TMSUXCO)

Modifies fields during conversion of data to TMC format or CA 1 control statements.

This exit is called by TMSCONVR.

CL05223

Obsolete

n/a

The master password is now set with the SHUTDWN option in TMOOPT00

CL05224

TMSXITD

TMSXITD (TMSUXID)

Converts system catalog data to TMC format during execution of TMSIDATA. Update option XITD in TMOOPT00 for this exit to be called.

CL05228

Obsolete

n/a

Use new option ROBSCR in member TMOOPT00 to notify robotic systems of scratch status.

CL05230

TMSXITF

TMSXITF (TMSUX2F)

Allows/disallows double opens and recreates.

Update option XITF in TMOOPT00 to call this exit.

CL05231

CTSJUX1G

CTSUX1G

Validates correct tape mounted for scratch sub-pool request, and reject a tape from being by Real-time Stacking.

CL05232

TMSXCLN1

TMSXCLN1

Modifies the expiration date and scratch status indicator, or bypass the TMC record update.

This exit is only called by TMSCLEAN if the option XCLN1 is set to the exit name.

CL05233

TMSXCLN2

TMSXCLN2

Processes CA 1 Keyword USER/uuu dates.

This exit is only called by TMSLCEAN if option XCLN2 is set to the exit name.

CL05234

TMSXCTLG

TMSXCTLG

Allows the expiration date and "expired by Catalog Control" indicator to be modified, or the TMC record update to be bypassed.

This exit is only called by TMSCTLG if the option XCTLG is set to the exit name.

CL05235

TMSXCYCL

TMSXCYCL

Modifies the expiration date of bypass the TMC record update.

This exit is only called by TMSCYCLE if the option XCYCL is set to the exit name.

CL05236

TMSXEXP

TMSXEXP

Allows modification of the expiration date and eligible for RDS indicator of the TMC record update to be bypassed.

This exit is only called by TMSEXPDT if the option XEXP is set to the exit name.

CL05237

TMSXOCAT

TMSXOCAT

Provides the TMC record selection for MVS catalog and TMC synchronization processing.

This exit is only called by TMSOSCAT if the option XOCAT is set to the exit name.

CL05238

TMSXTPNT

TMSXTPNT

Allows the user to reject volumes for label processing, modify the TMC record prior to TMC update, and modify tape label information.

This exit is only called by TMSTPNIT if option XTPNT is set to the exit name.

CL05239

TMSXTPPR

TMSXTPPR

Provides options to control the processing of tapes.

This exit is only called by TMSTPPRO if the option XTPPR is set to the exit name.

CL05240

TMSXVLT1

TMSXVLT1

Provides for TMC record selection for Vault Management System processing.

This exit is only called by TMSVMEDT if the option UXVLT1 is set to the exit name.

CL05241

TMSVOLDF

TMSVOLDF

Generates exit definitions for use with CA supplied user exits TMSXITU and TMSXITE. This is not needed if the TMC is reformatted with TMSXTEND.

Set XITE and XITU in TMOOPT00 to call the exits.

Release 12.6 is the last release to support this.

CL05242

Obsolete

n/a

Defines output assignments for external tape labels.

CL05243

TMSXSCR

TMSXSCR

Allows or disallows the scratch request and is called prior to updating any volumes and prior to updating any DSNBs. This exit is called for both a SCRATCH and a TEST request.

This exit is only called by TMSSCR if the option XSCR is set to the exit name

CL05244

CTSJUCBX

CBRUXENT, CBRUXEJC, and CBRUXVNL

The CTSJUCBX USERMOD should be applied in your z/OS SMP zone to reassemble the modules; CBRUXENT, CBRUXEJC, and CBRUXVNL in SYS1.LINKLIB.

Changed from CTSJUCBR and CTSJUCBX in r12.0 to CTSJUCBX in r12.6

CL05245

Obsolete

n/a

Scratch notification to robotic devices is now done by setting the ROBSCR option in TMOOPT00.

SMPHSM / SMPHSM2

Obsolete

n/a

The ARCTVEXT exit is always distributed with CA 1.

SMPBTLS

CTSJUBTL

IDCLI04

Used to install the IBM BTLS exit to set the category for scratch tapes.