SET PROCESSTYPE
Use the SET PROCESSTYPE command to change the attributes of a process-type.
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 BTS in a single CICS region, you can use the SET PROCESSTYPE command to modify your process-types. However, if you are using BTS 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 will be written from:
- The process audit points
- The activity primary audit points.
- FULL
- Full auditing. Audit records will be written from:
- The process audit points
- The activity primary and secondary audit points.
- OFF
- No audit trail records will be written.
- PROCESS
- Process-level auditing. Audit records will be 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).
