CICS Resources (2 R)

The CICS Resources screen (2.R) displays program and transaction resource information in place of the PPT and PCT control block display. This screen allows users to view formatted program and transaction resource information without having to interpret bit and byte values in control blocks.

This screen will also display Db2 information for resource types DB2CONN, DB2ENTRY, and DB2TRAN.

Enter a resource type and a resource name to display resource attributes in text format as shown in Program Attributes on the CICS Resources Screen (2.R) (Part 1). If a program is currently loaded, its attributes are displayed when the screen is accessed. If a program is not defined to CICS — and program autoinstall is active in the region — entering the program name causes Code Debug CICS to define the program automatically.

Cursor-sensitive field-level help is available for input fields and resource attributes.

Access this screen by typing the letter R on the Debugging Facilities Menu, or type =2.R in the COMMAND field. You can also access the screen from either Memory Display screen (2.2 or 9.2) by entering PCT, PPT, or RCT in the TABLE/AREA field.

Program Attributes on the CICS Resources Screen (2.R) (Part 1) and Program Attributes on the CICS Resources Screen (2.R) (Part 2) show the CICS Resources screen displaying program attributes, and Transaction Attributes on the CICS Resources Screen (2.R) (Part 1) and Transaction Attributes on the CICS Resources Screen (2.R) (Part 2) show the screen displaying transaction attributes.

Input Fields

RESOURCE TYPE

Used to select between the five types of displayable resources: programs, transactions, Db2 connection, Db2 entry, and Db2 transaction. Valid entries are:

• PROGRAM, PROG, or PGM
• TRANSACTION, TRANS, or TRAN
• DB2CONN or DB2C
• DB2ENTRY or DB2E
• DB2TRAN or DB2T

RESOURCE NAME

Name of a resource defined to CICS corresponding to the type specified in the RESOURCE TYPE field.

Program Attributes on the CICS Resources Screen (2.R) (Part 1)

Program Attributes on the CICS Resources Screen (2.R) (Part 2)

Output Fields

The output fields displayed for programs are obviously different from those displayed for transactions or Db2 resources. Resource signature fields are shown after other resource attributes. As shown in  Program Attributes on the CICS Resources Screen (2.R) (Part 1), these fields begin with CHANGEAGENT:. For more details, see the IBM documentation site.

Program Attributes

The following output fields are displayed when PROGRAM is specified as the type of resource. The fields are shown in Program Attributes on the CICS Resources Screen (2.R) (Part 1) and Program Attributes on the CICS Resources Screen (2.R) (Part 2), and they may vary depending on which release of CICS Transaction Server is in use.

APIST

Identifies the API attribute of the installed program definition. Possible values are:

• CICSAPI: The program is restricted to use of the CICS permitted application programming interfaces only.
• OPENAPI: The program is not restricted to use of the CICS permitted application programming interfaces only.

CEDFSTATUS

Displays diagnostic screens when the program executes under EDF. Possible values are:

• CEDF: EDF displays the diagnostic screens when the program executes under EDF.
• NOCEDF: EDF does not display any diagnostic screens when the program executes under EDF.
• N/A: EDF is not applicable, either because it is defined as remote, or because it is a mapset or partitionset.

COBOLTYPE

Identifies the type of COBOL being used — COBOL or COBOLII. Possible values are:

• COBOL, COBOLII
• N/A: The program is either not COBOL, or it is remote.
• NOTINIT: The program is COBOL, but has not yet been initialized, therefore the type cannot be determined.

COPY

The load status of the program. Possible values are:

• NOTREQUIRED: The program status is either loadable or not-loaded, and a SET PROGRAM NEWCOPY/PHASEIN operation is not required.
• REQUIRED: The program status is not-loadable. A SET NEWCOPY/PHASEIN command is required to reset the status to not-loaded, which will enable the program to be reloaded. Before issuing this command you should make sure the DFHRPL concatenation contains a copy of the program.

CONCURRENCY

Indicates whether the program is written to threadsafe standards or is only quasi-reentrant. Possible values are:

• QUASIRENT: The program is quasi-reentrant and relies on the serialization provided by CICS when accessing shared resources.
• THREADSAFE: The program is written to threadsafe standards and takes into account that other programs may be executing concurrently and attempting to modify the same resources.

DATALOCATION

Location of the data above or below the 16MB line. Possible values are:

• ANY: The program’s data can reside above or below 16MB.
• BELOW: The program’s data must reside below 16MB.
• N/A: The program is remote.

DYNAMSTATUS

Indicates whether the program can be dynamically routed if it is the subject of a program link request. Possible values are:

• DYNAMIC: The program can be dynamically routed if it is the subject of a program link request and no sysID option is specified on the link.
• NODYNAMIC: The dynamic routing program is not invoked if the program is the subject of a program link request.
• N/A: Either the program is not currently loaded or it is remote.

ENTRYPOINT

Possible values are the entry point of the program in the format X'xxxxxxxx' or blanks. If the program is not in use, the product displays blanks. The high order bit is set on if the program has been defined with AMODE=31.

EXECKEY

Designates which key the program executes in. Possible values are:

• CICSKEY: The program executes in CICS key and has read/write access to both CICS and user storage.
• USERKEY: The program executes in user key and has read/write access to user storage, but has only read access to CICS storage.
• N/A: The program is remote or has been defined as a mapset or partitionset.

EXECUTIONSET

Designates the subset of API for the program. Possible values are:

• DPLSUBSET: When the program runs in the local CICS region, it may use only the same subset of the API program that applies when the program is linked to by a DPL request.
• FULLAPI: The program can use the full CICS API.
• N/A: The program is remote or has been defined as a mapset or partitionset.

HOLDSTATUS

Designates whether or not the program was loaded with the HOLD option. Possible values are:

• HOLD: CICS loaded the program with the HOLD option.
• NOHOLD: CICS loaded the program without the HOLD option.
• N/A: The program was not loaded, or it is remote.

JVMCLASS

Specifies the main class in a Java program to be run under the control of a Java Virtual Machine (JVM).

JVMPROFILE

Specifies the name of the dataset member that contains the JVM profile.

LANGUAGE

Designates the language of the program. Possible values are:

• ASSEMBLER
• COBOL
• LE370
• C
• PL/I
• N/A
• NOTDEFINED

COBOL applies to both COBOL/VS and COBOL II programs. PL/I applies to OS PL/I, and PL/I for MVS & VM. N/A means that the program is remote. NOTDEFINED indicates that the language was not defined and that CICS has yet to determine the language.

LANGDEDUCED

Identifies the program language in which the module is written, if known. Until a module is loaded, CICS cannot deduce the language. In this case, the defined language will be taken from the resource definition. Possible values are:

• ASSEMBLER
• COBOL
• LE370
• C
• PL/I
• N/A
• NOTDEFINED

LENGTH

Program length. Possible values are:

• X'xxxxxxxx': Hexadecimal length of the program.
• Blanks: The program is not loaded.
• N/A: The program is remote.

LIBRARY

Identifies the name of the LIBRARY resource from which this program was loaded or blanks if the program is not loaded.

LIBRARYDSN

Identifies the 44-character name of the dataset from which the program was loaded or blanks if the program is not loaded.

LOADPOINT

The load address in the format X'xxxxxxxx', or blanks if the program is not loaded.

LPASTATUS

Identifies where the most recent copy of this program was loaded from. Possible values are:

• LPA: CICS loaded the most recent version of the program from either the LPA or the ELPA.
• NOTLPA: The most recent version of the program was a private copy, not from the LPA.
• N/A: CICS has not used either a private or LPA copy of the program.

PROGTYPE

Possible values are:

• MAPSET
• PARTITIONSET
• PROGRAM.

REMOTENAME

Identifies the name by which the program is known in the remote system (defined in the REMOTESYSTEM field). Possible values are an eight-character name or blanks (if the program is not remote).

REMOTESYSTEM

Identifies the name of the remote CICS region to which a link request for this program will be shipped. Possible values are a four-character name or blanks (if the program is not remote).

RESCOUNT

Possible values are the current rescount as a decimal value or N/A if the program is remote.

RUNTIME

Identifies the RUNTIME environment of the installed program definition. Possible values are:

• JVM: The program is a Java program that runs in a Java Virtual Machine (JVM).
• LE370: The program will run with Language Environment runtime support.
• NONLE370: The program will run with a language-specific runtime environment.
• NOTAPPLIC: RUNTIME does not apply because the module is a map set or a partition set.
• UNKNOWN: The program runtime environment is unknown, because the program has not been loaded by CICS.
• XPLINK: The program is a C or C++ program which has been compiled using the XPLINK option.

SHARESTATUS

Displays the location from which the program is loaded. Possible values are:

• N/A: The program is remote.
• PRIVATE: CICS loads the program from a DFHRPL library the next time it performs a NEWCOPY or PHASEIN for this program.
• SHARED: The next time CICS performs a NEWCOPY or PHASEIN request, it loads the program from the LPA if possible. If the program is not available in the LPA, it is loaded from DFHRPL.

STATUS

Indicates whether or not the program is available for use. Possible values are:

• ENABLED
• DISABLED.

TRANSID

Defines the name of the server transaction the remote region is to attach to this program when the program name is defined as remote. Possible values are a four-character name or blanks. Blanks indicate that no transid was specified on the program resource definition.

USECOUNT

Possible values are the current usecount as a decimal value or N/A. N/A indicates that the program is remote.

Transaction Attributes on the CICS Resources Screen (2.R) (Part 1)

Transaction Attributes on the CICS Resources Screen (2.R) (Part 2)

Transaction Attributes

The following output fields are displayed when TRANSACTION is specified as the type of resource. The fields are shown in Transaction Attributes on the CICS Resources Screen (2.R) (Part 1) and Transaction Attributes on the CICS Resources Screen (2.R) (Part 2), and they may vary depending on which release of CICS Transaction Server is in use.

BREXIT

Identifies the name of the bridge exit to be associated with this bridge transaction.

CMDSEC

Indicates whether external security manager performs command security checking for this transaction. Possible values are:

• YES: External security manager will perform command security checking for this transaction.
• NO: Command security checking is not active for this transaction.

DTIMEOUT

Shows the deadlock time-out value in seconds for suspended tasks associated with this transaction.

DUMPING

Shows whether CICS will produce transaction dumps if this transaction abends.

FACILITYLIKE

The name of an existing terminal resource definition to be used as a template for the bridge facility.

INDOUBT

Shows the action to be taken when a CICS region fails during two-phase commit processing and the unit of work is indoubt. If INDOUBTWAIT is YES, the INDOUBT action will not become effective until the INDOUBTWAITMINS expires. Possible values are:

• BACKOUT: All changes made to recoverable resources are backed out to the status they were before the start of the unit of work.
• COMMIT: All changes made to recoverable resources are committed and the inflight unit of work is marked complete.

INDOUBTMINS

Shows how many minutes a transaction is to wait before taking the action specified for INDOUBT if INDOUBTWAIT is YES. A value of zero means to wait indefinitely.

INDOUBTWAIT

Shows whether an indoubt unit of work is to wait before the action specified for INDOUBT is taken. Possible values are:

• NO: CICS is to immediately take the action specified for INDOUBT.
• YES: CICS is to wait until the value of INDOUBTMINS expires before taking the action specified for INDOUBT.

ISOLATEST

Indicates whether user-key lifetime storage is kept separate from all user-key programs of all other tasks. Possible values are:

• YES: User-key task-lifetime storage is isolated from all user-key programs of all other tasks. The transaction is not accessible to user-key programs.
• NO: The storage is accessible by this transaction’s programs, plus the user-key programs of other transactions defined with the ISOLATEST(NO) option.

OTSTIMEOUT

This field displays the transaction’s value for OTSTIMEOUT.

PRIORITY

The transaction’s priority relative to other transactions in the region. Possible values are 1 to 255.

PROFILE

Shows the eight-character profile name for this transaction.

PROGRAM

Shows the name of the first program to be executed when the transaction starts. The program name is eight characters.

PURGEABILITY

Describes whether the transaction is purgeable in system stall conditions. Possible values are YES and NO.

REMOTENAME

The name by which the transaction is known in the remote system named in the REMOTESYSTEM field. Possible values are blanks or an 8-character remote system name. Blanks indicate that the transaction is not remote.

REMOTESYSTEM

The name of the remote system on which the transaction is defined. Possible values are a four-character remote system name or blanks. Blanks indicate that the transaction is not remote.

RESSEC

Shows whether an external security manager will perform resource security checking for this transaction. Possible values are YES or NO.

ROUTING

Describes the routing status of the transaction. Possible values are DYNAMIC or STATIC. DYNAMIC indicates that the transaction is eligible for dynamic routing. STATIC indicates that the transaction is not eligible for dynamic routing.

ROUTESTATUS

This field shows whether a transaction can be dynamically routed if it is the subject of an eligible EXEC CICS START command. Possible values are ROUTABLE and NOTROUTABLE.

• ROUTABLE: The transaction can be dynamically routed if it is the subject of an eligible START command.
• NOTROUTABLE: The transaction cannot be dynamically routed if it is the subject of an eligible START command.

RTIMEOUT

Displays the read time out value in seconds after which a task associated with this transaction will terminate if it receives no input.

RUNAWAY

The number of milliseconds the task associated with this transaction can have control over the processor. After the specified amount of time, the task is assumed to be in a loop, and CICS abnormally terminates it. A value of zero indicates that no runaway task detection will be performed for this transaction.

RUNAWAYTYPE

Displays how the RUNAWAY time is set. Possible values are SYSTEM or USER. SYSTEM indicates that CICS uses the current system runaway time. USER indicates that CICS uses the limit set by the user.

SCRNSIZE

Displays the type of screen size. Possible values are ALTERNATE or DEFAULT. ALTERNATE indicates that the transaction will use an alternate screen size. DEFAULT indicates that the transaction will use the default screen size.

SHUTDOWN

Shows whether or not the task will continue to run during shutdown. Possible values are DISABLED or ENABLED. DISABLED indicates that the tasks associated with this transaction will not continue to run during shutdown. ENABLED indicates that the tasks will continue to run during shutdown.

STATUS

Displays the status of the transaction. Possible values are DISABLED or ENABLED. DISABLED indicates that the transaction is not available for use. ENABLED indicates that the transaction is available for use.

STORAGECLEAR

Indicates whether or not CICS will clear storage for a task associated with this transaction when the storage is released. Possible values are YES or NO.

TASKDATAKEY

Shows where CICS gets storage from for the transaction. Possible values are CICSKEY or USERKEY. CICSKEY indicates that CICS will get storage for the transaction from CICS-key storage. USERKEY indicates that the storage will come from user-key storage.

TASKDATALOC

Shows where the transaction can access task-related data. Possible values are ANY or BELOW. ANY indicates that transaction can access task-related data above or below the 16MB line. BELOW indicates that the transaction requires task-related data (such as the TWA and EIB) be accessed below the 16MB line.

TRACING

Indicates the type of tracing for this transaction. Possible values are SPECIAL, SUPPRESSED, or STANDARD.

TRANCLASS

Displays an eight-character transaction class name. If the transaction does not belong to a class, the product displays DFHTCL00.

TRPROF

Displays the profile name for transaction routing. This field contains a profile name of eight characters or blanks. Blanks indicate a local transaction.

TWASIZE

Shows the size of the Transaction Work Area (TWA) in bytes in the format X'xxxxxxxx'.