Inserting an APPC Element


DELTA IMS allows you to modify the APPC TP_PROFILE data set. If APPC is selected from the Edit Insert panel, DELTA IMS displays the DELTA List entry shown in the following figure. This entry adds information to the APPC TP_PROFILE data set.

To use an existing APPC element as a basis for creating a new APPC element, see Copying-and-Revising-DELTA-List-Elements.

Warning

Note

To revise an existing entry in the TP_PROFILE data set, the existing entry must be deleted and then added again with the updated information.

Edit DELTA List Panel - APPC

 ED                        DELTA IMS - Edit DELTA List
 Command ===> ________________________________________________ Scroll ===> PAGE

 DELTA Mode  . . . 3   1. Summary   2. Modified   3. Detail
 Restricting IMSID ****
 DELTA List  . . . APPC1___                            Element 000001 of 000001
 Title . . . . . . ______________________________
 ------ --------------- ----------------------------------- -------------
 000001 ADD APPC        TP_Profile name . . . . . . . . . . _____________ <==REQ
            APPCTYPE    APPC/MVS information type . . . . . TP_PROFILE___
            API_TYPE    API type (Explicit or Implicit) . . IMPLICIT_____
            ACTIVE      TP Profile active to APPC/MVS?. . . YES__________
            LEVEL       TP Profile audience level . . . . . SYSTEM_______
            LVLID       TP Levels group or user id. . . . . NONE_________
            SCHED       TP Sched_EXIT name. . . . . . . . . DFSTPPE0_____
            TRAN        IMS Transaction id. . . . . . . . . _____________ <==REQ
            ICLASS      IMS scheduling class. . . . . . . . 1____________
            MAXREGN     Number of dependent regions . . . . 1____________
            SECURITY    RACF security (NONE,CHECK,FULL) . . CHECK________
            COMMENT     Optional comment. . . . . . . . . . _____________
 ******************************* BOTTOM OF DATA ********************************

 

The following fields are available on this panel:

ADD APPC

Type the name of the transaction program (TP) in the ADD APPC field. The TP name can be up to 12 characters long.

APPCTYPE

Specify the type of APPC/MVS information you want to add, delete, or modify in the APPCTYPE field. TP_PROFILE is currently the only valid value for this field.

API_TYPE

Specify whether the TP uses the implicit or explicit API to retrieve or receive the initial data for the transaction in the API_TYPE field. Type IMPLICIT or I if the TP uses DL/I communications facilities to retrieve the initial data for the transaction from the IO-PCB; type EXPLICIT or E if the TP uses SAA communications facilities to allocate resources and receive the initial transmission data for the transaction. See the appropriate IBM publication for additional information.

ACTIVE

Type YES or NO in the ACTIVE field to specify whether the TP_PROFILE data set is active to APPC/MVS.

LEVEL

Specify the TP_PROFILE audience level in the LEVEL field. Valid values for this field are SYSTEM, GROUPID, and USERID. Type SYSTEM if the TP can be used by all users on the system, GROUPID if only a specific group of users will use the TP, or USERID if only a particular user will use the TP.

LVLID

If you specified GROUPID or USERID in the LEVEL field, use this field to specify the group ID or user ID.

SCHED

Specify the exit used to check syntax of the scheduler section of the TP_PROFILE data in the SCHED field. DFSTPPE0 is the only valid value for this field; this exit is supplied by IBM with IMS.

Warning

Note

For DELTA IMS to update the TP_PROFILE data set, you must include this module in a LINKLIST data set.

TRAN

Type the IMS transaction code to be associated with this TP name in the TRAN field. The transaction code can be up to eight characters long.

If you specified IMPLICIT in the API_TYPE field, the transaction code must be defined to IMS. If you specified EXPLICIT in the API_TYPE field, the transaction code must not be defined to IMS. When you execute the DELTA List, DELTA IMS checks whether the transaction code you specify in this field has been defined to IMS.

ICLASS

If you specified EXPLICIT in the API_TYPE field, specify a value of 1 through 256 for the IMS scheduling class. This field is ignored if you specified IMPLICIT in the API_TYPE field.

MAXREGN

If you specified EXPLICIT in the API_TYPE field, specify the maximum number of dependent regions that this TP can use in the MAXREGN field. Valid values are 0 through 255. This field is ignored if you specified IMPLICIT in the API_TYPE field.

SECURITY

Specify the type of RACF security that IMS should use for this TP. Valid values for this field are NONE, CHECK, and FULL ; CHECK is the default. Type NONE if IMS should call the DFSCTRN0 exit. Type CHECK if IMS should call RACF when IMS receives a transaction for this TP. Type FULL if IMS should clone the security environment when the TP is executed. See the appropriate IBM publication for additional information.

COMMENT

Use the COMMENT field to type a user comment.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

DELTA IMS products 6.8