SET PROCESSTYPE

Change the attributes of a CICS® business transaction services (CBTS) process-type.

Syntax

Warning: System commands are powerful as they provide information about the state of the system and allow changes to be made to it. System commands should be used only by authorized applications and users.

Activate security checks on commands by specifying the XCMD system initialization parameter and by ensuring that command security checking is active for the transaction (either by specifying CMDSEC(YES) on the TRANSACTION resource definition or by specifying ALWAYS on the CMDSEC system initialization parameter).

SET PROCESSTYPE

Read syntax diagramSkip visual syntax diagramSETPROCESSTYPE(data-value )STATUS(cvda)DISABLEDENABLEDAUDITLEVEL(cvda)ACTIVITYFULLOFFPROCESS

Conditions: INVREQ, NOTAUTH, PROCESSERR

NOHANDLE, RESP, and RESP2 are common options that can be added to all EXEC CICS commands to process error conditions. They are not explicitly included in the command syntax diagram and option descriptions. For information about these common options and EXEC CICS command syntax, see EXEC CICS command format and programming considerations. For more information about the use of CVDAs, see CICS-value data areas (CVDAs).

Description

SET PROCESSTYPE allows you to change the current state of audit logging and the enablement status of PROCESSTYPE definitions installed on this CICS region.

Note: Process-types are defined in the process-type table (PTT). CICS uses the entries in this table to maintain its records of processes (and their constituent activities) on external data sets. If you are using CBTS in a single CICS region, you can use the SET PROCESSTYPE command to modify your process-types. However, if you are using CBTS in a sysplex, it is strongly recommended that you use CICSPlex® SM to make such changes. This is because it is essential to keep resource definitions in step with each other, across the sysplex.

Options

AUDITLEVEL(cvda)
specifies the level of audit logging to be applied to processes of this type.
Note: If the AUDITLOG attribute of the installed PROCESSTYPE definition is not set to the name of a CICS journal, an error is returned if you try to specify any value other than OFF.
The CVDA values are:
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.

PROCESSTYPE(value)
specifies the 8-character name of a process-type defined in the process-type table (PTT), whose attributes are to be changed.
STATUS(cvda)
specifies whether new processes of this type can be created. The CVDA values are:
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.

Conditions

INVREQ
RESP2 values:
2
The process-type is not disabled, and therefore cannot be enabled.
3
You have specified an invalid CVDA value on the AUDITLEVEL option.
5
You have specified an invalid CVDA value on the STATUS option.
6
You have specified a value of FULL, PROCESS, or ACTIVITY on the AUDITLEVEL option, but the AUDITLOG attribute of the PROCESSTYPE definition does not specify an audit log.
NOTAUTH
RESP2 values:
100
The user associated with the issuing task is not authorized to use this command.
PROCESSERR
RESP2 values:
1
The process-type named in the PROCESSTYPE option is not defined in the process-type table (PTT).