CEMT INQUIRE TSMODEL
Retrieve information about temporary storage (TS) models.
In the CICS Explorer, the TS models operations view provides a functional equivalent to this command.
Description
The CEMT INQUIRE TSMODEL command returns information about temporary storage models.
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
- Type
CEMT INQUIRE TSMODEL
(or suitable abbreviations for the keywords). The resulting display lists the status. - Type
CEMT INQUIRE TSMODEL
(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 entercemt i tsm main
, the resulting display shows the details of only temporary storage models for main temporary storage queues.
If you place the cursor against a specific entry in the list and press Enter, CICS® displays an expanded format.
To change various attributes, overtype your changes on the INQUIRE screen after tabbing to the appropriate field (see Overtyping a display).
- ALL
- The default.
- (value)
- The name of the temporary storage model for which information is requested.
Displayed fields
- 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.
- EXPIRYINTMIN(value)
- Displays the expiry interval, in minutes, for temporary storage queues associated with this TS model. CICS uses the value rounded up to the nearest multiple of 10 minutes. If a temporary storage queue is not referenced during its expiry interval, it becomes eligible to be deleted automatically by CICS. A value of zero means that no expiry interval applies to queues matching this model, so they are never eligible for automatic deletion. CICS does not apply an expiry interval to recoverable, remote, or temporary storage queues, or temporary storage queues created by CICS. Starting with CICS TS 5.2, the expiry interval now also applies to shared temporary storage queues.
- 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.
- LOCATION
- Displays
the location where temporary storage queues associated with this TS
model reside. The values are:
- AUXILIARY
- TS queues associated with this TS model are held in the auxiliary temporary storage VSAM data set DFHTEMP, or in temporary storage pools in the coupling facility.
- MAIN
- TS queues associated with this TS model are held in main storage.
- POOLNAME(value)
- Displays an 8-character shared pool name.
- PREFIX(value)
- Displays the prefix for this model as a 16-character string.
- RECOVSTATUS
- Displays
the recovery status of the temporary storage queue. The values are
as follows:
- RECOVERABLE
- The temporary storage queue is recoverable.
- NOTRECOVABLE
- The temporary storage queue is not recoverable.
- REMOTEPREFIX(value)
- Displays the remote prefix for this model as a 16-character string.
- REMOTESYSTEM(value)
- Displays the remote system name for this model as a 4-character string.
- SECURITYST
- Displays
the security status for this model. The values are as follows:
- SECURITY
- Security checking is performed for queue names matching this model.
- NOSECURITY
- Security checking is not performed for queue names matching this model.
- TSMODEL(value)
- Indicates
that this panel relates to a TSMODEL inquiry and displays the 8-character
name of a temporary storage model. Note: Nondisplayable characters appear as periods. You can use PF2 on the expanded panel to see the value in hexadecimal.