INQUIRE PROCESSTYPE

Description

INQUIRE PROCESSTYPE returns the attributes of a specified process type.

Browsing

You can also browse through all of the process type definitions in your system by using the browse options, START, NEXT, and END, on INQUIRE PROCESSTYPE commands. See Browsing resource definitions for general information about browsing, including syntax, exception conditions, and examples.

The resource signature

You can use this command to retrieve 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 BUNDLE, 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.

Options

AUDITLEVEL(cvda)

Indicates the level of audit currently active for processes of the specified type. CVDA values are as follows:

ACTIVITY

Activity-level auditing. Audit records are written from these points:

• The process audit points
• The activity primary audit points.

FULL

Full auditing. Audit records are written from these points:

• 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.

AUDITLOG(data-area)

Returns the 8-character name of the CICS journal used as the audit log for processes of the specified type.

CHANGEAGENT(cvda)

Returns a CVDA value that identifies the agent that made the last change to the resource definition. 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(data-area)

Returns a 4-digit number of the CICS release that was running when the resource definition was last changed.

CHANGETIME(data-area)

Returns an ABSTIME value that represents the time stamp when the resource definition was last changed. For more information about the format of the ABSTIME value, see FORMATTIME.

CHANGEUSRID(data-area)

Returns the 8-character user ID that ran the change agent.

DEFINESOURCE(data-area)

Returns the 8-character source of the resource definition. The DEFINESOURCE value depends on the CHANGEAGENT value. For more information, see Summary of the resource signature field values.

DEFINETIME(data-area)

Returns an ABSTIME value that represents the time stamp when the resource definition was created.

FILE(data-area)

Returns the 8-character name of the CICS file associated with the process-type.

INSTALLAGENT(cvda)

Returns a CVDA value that identifies the agent that installed the resource. 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(data-area)

Returns an ABSTIME value that represents the time stamp when the resource was installed.

INSTALLUSRID(data-area)

Returns the 8-character user ID that installed the resource.

PROCESSTYPE(data-value)

Specifies the name (1 - 8 characters) of the process type being inquired on.

STATUS(cvda)

Indicates whether new processes of the specified type can currently be defined. CVDA 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.

Conditions

NOTAUTH

RESP2 values:

100

The user associated with the issuing task is not authorized to use this command.

101

The user associated with the issuing task is not authorized to access this resource in the way requested.

PROCESSERR

RESP2 values:

1

The process type specified on the PROCESSTYPE option cannot be found.