CEMT INQUIRE PROCESSTYPE

Retrieve information about a CICS® business transaction services process-type.

In the CICS Explorer, the Processtypes operations view provides a functional equivalent to this command.

Description

The INQUIRE PROCESSTYPE command returns information about the BTS PROCESSTYPE definitions installed on this CICS region. It shows the current state of audit logging for each displayed process-type.

The resource signature

You can use this command to display the resource signature fields. You can use these fields to manage resources by capturing details of when the resource was defined, installed, and last changed. For more information, see Auditing resources. The resource signature fields are CHANGEAGENT, CHANGEAGREL, CHANGETIME, CHANGEUSRID, DEFINESOURCE, DEFINETIME, INSTALLAGENT, INSTALLTIME, and INSTALLUSRID. See Summary of the resource signature field values for detailed information about the content of the resource signature fields.

Input

Press the Clear key to clear the screen. You can start this transaction in two ways:
  • Type CEMT INQUIRE PROCESSTYPE (or suitable abbreviations for the keywords). The resulting display lists the current status.
  • Type CEMT INQUIRE PROCESSTYPE (or suitable abbreviations for the keywords), followed by the attributes that are necessary to limit the range of information that you require. For example, if you enter cemt i proc en, the resulting display shows the details of only those process-types that are enabled.
You can change various attributes in the following ways:
  • Overtype your changes on the INQUIRE screen after tabbing to the appropriate field.
  • Use the CEMT SET PROCESSTYPE command.
ALL
The default. Information about all process-types is displayed, unless you specify a selection of process-types to be queried.
(value)
The name (1 - 8 characters) of one or more PROCESSTYPE definitions installed in the process-type table (PTT).

Sample screen

Figure 1. CEMT INQUIRE PROCESSTYPE screen
I PROC
STATUS:   RESULTS - OVERTYPE TO MODIFY
 Pro(PROCESSTYPE12  ) Fil(FILE12  ) Aud(ADTLOG12) Pro Ena
 Pro(PROCESSTYPE13  ) Fil(FILE13  ) Aud(ADTLOG12) Off Ena
 Pro(PTYPE2B        ) Fil(FILE2B  ) Aud(DFHJ2B  ) Ful Ena
 Pro(PTYPE39        ) Fil(FILE39  ) Aud(DFHJ39  ) Off Ena
 Pro(SALESTYPE1     ) Fil(SALESF1 ) Aud(PLOG51  ) Off Dis
 Pro(SALESTYPE4     ) Fil(SALESF4 ) Aud(PLOG51  ) Act Ena
 Pro(SALESTYPE6     ) Fil(SALESF6 ) Aud(PLOG51  ) Off Ena

If you place the cursor against a specific entry in the list and press ENTER, CICS displays an expanded format as shown in Figure 2.

Figure 2. The expanded display of an individual entry
 I PROC
 STATUS:   RESULTS - OVERTYPE TO MODIFY
   Processtype(SALESTYPE4     )
   File(SALESF4 )
   Enablestatus( Enabled )
   Auditlog(PLOG51  )
   Auditlevel(Activity )

CEMT INQUIRE PROCESSTYPE

Read syntax diagramSkip visual syntax diagramCEMT INQUIRE PROCESSTYPEALL( value)FILE( value) ACTIVITYFULLOFFDISABLEDENABLEDINSTALLTIME( date time)INSTALLUSRID( value)CREATESPICSDAPIGRPLISTDEFINESOURCE( value)DEFINETIME( date time)CHANGETIME( date time)CHANGEUSRID( value)CREATESPICSDAPICSDBATCHDREPAPICHANGEAGREL( value)

Displayed fields

AUDITLEVEL
Displays the level of audit logging currently active for processes of this type. The values are as follows:
ACTIVITY
Activity-level auditing. Audit records are written from:
  1. The process audit points
  2. The activity primary audit points.
FULL
Full auditing. Audit records are written from:
  1. The process audit points
  2. The activity primary and secondary audit points.
OFF
No audit trail records are written.
PROCESS
Process-level auditing. Audit records are written from the process audit points only.

For details of the records that are written from the process, activity primary, and activity secondary audit points, see Specifying the level of audit logging.

AUDITLOG(value)
Displays the 8-character name of the CICS journal used as the audit log for processes of this type.
CHANGEAGENT(value)
Displays a value that identifies the agent that made the last change to the resource definition. You cannot use CEMT to filter on some of these values because they are duplicated. The possible values are as follows:
CREATESPI
The resource definition was last changed by an EXEC CICS CREATE command.
CSDAPI
The resource definition was last changed by a CEDA transaction or the programmable interface to DFHEDAP.
CSDBATCH
The resource definition was last changed by a DFHCSDUP job.
DREPAPI
The resource definition was last changed by a CICSPlex SM BAS API command.
CHANGEAGREL(value)
Displays the 4-digit number of the CICS release that was running when the resource definition was last changed.
CHANGETIME(date time)
Displays the date and time when the resource definition was last changed. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.
CHANGEUSRID(value)
Displays the 8-character user ID that ran the change agent.
DEFINESOURCE(value)
Displays the source of the resource definition. The DEFINESOURCE value depends on the CHANGEAGENT option. For details, see Summary of the resource signature field values.
DEFINETIME(date time)
Displays the date and time when the resource was created. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.
ENABLESTATUS
Displays whether new processes of this type can be created. The values are as follows:
DISABLED
The installed definition of the process-type is disabled. New processes of this type cannot be defined.
ENABLED
The installed definition of the process-type is enabled. New processes of this type can be defined.
FILE(value)
Displays the 8-character name of the CICS repository file on which the process and activity records for processes of this type are stored.
INSTALLAGENT(value)
Displays a value that identifies the agent that installed the resource. You cannot use CEMT to filter on some of these values because they are duplicated. The possible values are as follows:
CREATESPI
The resource was installed by an EXEC CICS CREATE command.
CSDAPI
The resource was installed by a CEDA transaction or the programmable interface to DFHEDAP.
GRPLIST
The resource was installed by GRPLIST INSTALL.
INSTALLTIME(date time)
Displays the date and time when the resource was installed. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.
INSTALLUSRID(value)
Displays the 8-character user ID that installed the resource.
PROCESSTYPE(value)
Indicates that this panel relates to a PROCESSTYPE inquiry and displays the 8-character name of a process-type.