APPC/MVS Administration utility (ATBSDFMU) example

The following example is an APPC/MVS Administration utility (ATBSDFMU) entry.

TPADD TPSCHED_EXIT(DFSTPPE0)
      TPNAME(INQUIRY_PART)
      SYSTEM
      ACTIVE(YES)
      TPSCHED_DELIMITER(##)
          TRANCODE=PART
          CLASS=1
          MAXRGN=1
                                  CPUTIME=0  
          ##

In this example, the IMS section starts with TRANCODE=PART. The other control statements are shown for completeness.

The IMS TP_Profile parsing module, DFSTPPE0, performs validity checking and parses the input data in IMS. This module should be loaded into the STEPLIB data set of the step that adds the TP_Profile. The APPC/MVS Administration utility (ATBSDFMU) requires that STEPLIB be APF authorized.

The following five keywords are used to add an IMS section to the TP_Profile entry. The keyword-parameter sets must be separated by one or more blanks. The keyword-parameter sets must be specified between columns 1-72. An asterisk (*) in column 1 indicates a comment.

TRANCODE= 1 - 8 characters

Name of the IMS transaction code associated with this TP name consisting of alphanumeric or '#', '$', '@'. IMS translates the TP name to the TRANCODE. IMS scans for valid characters (00640 character set). If invalid characters exist, IMS uses the default transaction code, IMSTRAN, instead of a transaction code with the non-00640 characters.

CLASS= 1 - 999

Specifies the class used for scheduling. The default value is 1.

Recommendation: Define CPI transactions with a different message class from that used for non-CPI transactions. IMS handles all CPI transactions as priority zero within the transaction class.

MAXRGN= 0 - 999

Restricts the number of dependent regions that this CPI Communications driven transaction program can use. The default value is 1.

RACF®=NONE, CHECK, or FULL

RACF=NONE causes IMS to call the Transaction Authorization exit routine (DFSCTRN0).

RACF=CHECK causes IMS to call RACF for security checking when IMS receives a transaction (using RCLASS of TIMS or CIMS), but does not clone the security environment into the dependent region when the transaction executes.

RACF=FULL clones the security environment to the dependent region at execution time. Specifying this parameter and issuing the IMS command /SECURE APPC PROFILE enables APSB SAF Security for this CPI-C application program.

CPUTIME= 0 - 1440

Specifies the number of CPU seconds that the CPI-C program is allowed to use. If it exceeds the limit, it is terminated with ABENDU0240. This time limit protects against program loops, which locks resources from other applications. The default is 0, which is no limit.

You can use the TP_Profile entry in two ways:

To specify an IMS transaction code that is defined in the IMS. The CLASS and MAXRGN parameters in the TP_Profile are ignored and the transaction values in IMS remain unchanged. The TP_Profile entry provides mapping for a 64-character TPN into an 8-character transaction code.
To specify an IMS transaction code that is not defined in the IMS. The IMS transaction code is a CPI Communications driven transaction, and is used as the load module name of the scheduled application program and the dynamically built transaction name.

When a TP_Profile is not defined, IMS uses the first 8 bytes of the TPN translated to the IMS character set as the transaction code.

The allocate request is rejected if the transaction code is not valid.

Related reading: For more information about using the APPC/MVS Administration utility (ATBSDFMU), see z/OS® MVS Planning: APPC/MVS Management.