SET PROCESSTYPE
Change the attributes of a CICS® business transaction services (CBTS) 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 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 CPSM 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:
- The process audit points
- The activity primary audit points.
- FULL
- Full auditing. Audit records are written from:
- The process audit points
- 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).