Previous Topic: Advanced Demo Session for PL/INext Topic: Messages and Diagnostics

DDnames and Sample CLISTs

DDnames and Sample CLISTs

This section contains the following topics:

DDnames Required for Proper Execution

Optional DDnames

Sample CLISTs to Invoke the Application

Other CLISTs

DDnames Required for Proper Execution

This section contains a list of the ddnames used by the application and a brief description of their use.

DCB information, where given, is that which is set and used by the application.

DDname

Description

INT1LOAD

Defines the partitioned data set (PDS) that contains the load modules. This library is built during installation.

INT1MSGL

Defines the partitioned data set that contains the application messages. This library is built during installation.

INT1PARM

Defines the partitioned data set that contains the application parameters. This library is built during installation.

Note: The parameters are internal to the application and are documented. For information on how these parameters are documented, see Step 15. Customize Options in the chapter “Installation” in the Installation Guide.

INT1PNLL

Defines the partitioned data set that contains the panel definitions. This library is built during installation.

INT1PROF

Defines the partitioned data set used to maintain user‑related data from session to session. This library must be defined by the installation. For information on how to allocate the profile library, see Step 14a. Allocate PROFLIB of the “Installation” chapter in the Installation Guide.

Optional DDnames

These ddnames are used during certain processes. If you are using the designated application facility, you must allocate these files before using that part of your product.

It is usually prudent to include the necessary allocation of ddnames to DSN in the CLIST that invokes the application.

DDname

Description

INT1PRNT *

Defines a sequential file used to print the screen images. If it is not allocated, the screen image feature is disabled. For more information on printing screens, see the print key description in Program Function and Program Access Keys in the chapter "System Overview."

Note: This DD is used only under CA Roscoe.

  • LRECL=121, BLKSIZE=6171, RECFM=FBA

INT1REPT

Defines a sequential file used to store the HISTogram and XSUM reports. If it is not allocated, the HIST and XSUM commands are disabled. For more information on the reports, see the HIST and XSUM Report Command descriptions in the chapter "Debugging Commands."

  • LRECL=131,BLKSIZE=6157,RECFM=FBA

INT1ALIB

Defines the partitioned data set that contains allocation sets saved under option 3, ALLOCATION. If it is not allocated, the save and retrieve features are disabled. For more information on allocating data sets and saving the allocations, see the chapter "Allocations Facility for ISPF."

  • LRECL=150, BLKSIZE=3150, RECFM=FB

INT1CLIB

Defines the partitioned data set that contains application commands to be used by the INCLUDE command. If it is not allocated, the INCLUDE command is disabled. For more information, see the Include Control Command in the chapter "Debugging Commands."

  • LRECL=80, RECFM=FB

INT1CLOG

Defines a sequential file used for the application session log. If it is not allocated, logging is disabled. For more information on the session log, see Session Log Facility (Review Debugging Session) in the chapter "Debugging Commands."

  • LRECL=80, BLKSIZE=6160, RECFM=FB

SYSOUT

Although SYSOUT is not used by the application, it is recommended that it be allocated to the terminal to prevent ABENDS while processing COBOL DISPLAY or EXHIBIT verbs that may have been left in the program.

Sample CLISTs to Invoke the Application

The CAICLIB contains five sample CLISTs for invoking the application in different program testing environments. The following table describes the sample CLISTs:

Name

Description

MR85CLST

Sample CLIST for application testing.

MR85CIMS

Sample CLIST for testing of IMS programs in foreground.

MR85CBTS

Sample CLIST for testing of IMS programs using BTS input in foreground.

MR85CDB2

Sample CLIST for testing of DB2 programs in foreground.

CAMRDRVR

Sample CLIST that provides a front-end to the other four CLISTs.

Other CLISTs

The application contains several other CLISTs for your use. They are described in the following table:

Name

Description

MR85STRT

This gets called under an ISPF NEWAPPL and calls the program to start the application. MR85KEYS can be called from this CLIST to set the PF Keys

MR85KEYS

This gets called from the CLIST MR85STRT to set up initial PF key settings for this APPL. By default, all of the PF keys are set to an initial value. By default, the PF keys will only be set once. To have the PF keys reset, modify the variable CHANGED.

INT1ALIB

This CLIST conditionally creates an ALIB data set. It can be called from your startup CLIST.

INT1CLIB

This CLIST conditionally creates a command library data set. It can be called from your startup CLIST.

INT1CLOG

This CLIST conditionally creates a session log data set. It can be called from your startup CLIST.

INT1PROF

This CLIST conditionally creates an application profile data set. It can be called from your startup CLIST.

INT1REPT

This CLIST conditionally creates a user report data set. It can be called from your startup CLIST.