Temporary storage model definitions - TSMDEF

The Temporary storage model definition (TSMDEF) views display information about the attributes of temporary storage models defined in the CPSM data repository. When installed in a target CICS system, these temporary storage model attributes govern the characteristics of CICS temporary storage queues, whose names generically match that of the prefix field.

Supplied views

To access from the main menu, click:

Administration views > CICS resource definitions > Temporary storage model definitions

Table 1. Views in the supplied Temporary storage model definitions (TSMDEF) view set
View Notes
Temporary storage model definitions

EYUSTARTTSMDEF.ADDTOGRP

Add one or more temporary storage model definitions to a resource group.
Temporary storage model definitions

EYUSTARTTSMDEF.CREATE

Create a temporary storage model definition and add it to the data repository.
Temporary storage model definitions

EYUSTARTTSMDEF.DETAILED

Detailed information about a selected temporary storage model definition.
Temporary storage model definitions

EYUSTARTTSMDEF.INSTALL

Install a temporary storage model definition in an active system.
Temporary storage model definitions

EYUSTARTTSMDEF.REMOVE

Remove a temporary storage model definition from the data repository.
Temporary storage model definitions

EYUSTARTTSMDEF.TABULAR

Tabular information about all temporary storage model definitions for the current context.

Actions

Table 2. Actions available for TSMDEF views
Action Description
ADDTOGRP Add one or more temporary storage model definitions to a resource group.
CREATE Create a temporary storage model definition and add it to the data repository.
CSDCOPY Copy a CICS CSD resource definition.
CSDINSTALL Install a CICS CSD resource definition into an active system.
INSTALL Install a temporary storage model definition in an active system.
REMOVE Remove a temporary storage model definition from the data repository.
UPDATE Update a temporary storage model definition in the data repository.

Fields

Table 3. Fields in TSMDEF views
Field Attribute name Description
Last modification agent CHANGEAGENT The change agent identifier that made the last modification.
  • DREPAPI - Resource was last changed by a CICSPlex SM API command.
Last modification agent release CHANGEAGREL The CICS release level of the agent that made the last modification.
Last modification time CHANGETIME The local time when the definition was last changed.
Last modification user ID CHANGEUSRID The user ID that made the last modification.
Time created CREATETIME The local date and time when the definition was last changed.
CSD group CSDGROUP The name of the CSD group for this CICS resource definition. This field is ignored for BAS definitions.
Version DEFVER The version number of the BAS resource definition, from 1 to 15. This field is ignored for CICS CSD resource definitions.
Description code page DESCCODEPAGE The code page of the description field. This field is ignored for CICS CSD resource definitions.
Description DESCRIPTION A description of the temporary storage model definition.
TS Queue expiry interval (hours) EXPIRYINT This parameter is deprecated for CICS TS 5.2 and higher, and is ignored if any value for EXPIRYINTMIN is specified. This parameter specifies the last used interval limit time, in hours which is used to determine whether a temporary storage queue based on this TSMODEL has expired and is eligible to be automatically deleted. The value in the TSMODEL at the time a temporary storage queue is created will be used for the lifetime of a queue even if the TSMODEL is subsequently changed. The value of EXPIRYINT can be in the range of 0-to-15000.
  • 0 - Indicates that no expiry interval applies to this TSMODEL and therefore a temporary storage queue based on this will never expire. This is the default value.
  • value - Specifies the last used interval in hours after which the queue becomes eligible for automatic deletion.
TS Queue expiry interval (minutes) EXPIRYINTMIN This parameter applies to CICS TS 5.2 and higher. It specifies the last used interval limit time, in minutes. It overrides any value specified for EXPIRYINT and is used to determine whether a temporary storage queue based on this TSMODEL has expired and is eligible to be automatically deleted. The value in the TSMODEL at the time a temporary storage queue is created will be used for the lifetime of a queue even if the TSMODEL is subsequently changed. The value of EXPIRYINTMIN can be in the range of 0-to-900000.
  • 0 - Indicates that no expiry interval applies to this TSMODEL and therefore a temporary storage queue based on this will never expire. This is the default value.
  • value - Specifies the last used interval in minutes after which the queue becomes eligible for automatic deletion.
Queue location LOCATION Specifies whether the queue is to be held in auxiliary or main storage:
  • AUXILIARY - Queues matching this model are to be held on auxiliary storage. Whatever is specified on the API request is disregarded.
  • MAIN - Queues matching this model are to be held in main storage. Whatever is specified on the API request is disregarded.
Note: TSMODEL definitions created using the Migrate command have their location attribute set to the default value AUXILIARY. LOCATION is ignored for remote TSMODELs and shared TS pool models. Using LOCATION on a remote entry allows the same definition to be installed in both a local and remote region.
Name NAME The name of the temporary storage model definition.
Shared TS pool name POOLNAME the 8-character name of the shared temporary storage pool definition that you want to use with this TSMODEL definition. The name can be up to eight characters in length.
TS queue prefix PREFIX The character string that is to be used as the prefix for this model. The prefix may be up to 16 characters in length.

You can use either uppercase, or lowercase, or a mixture of the two for the prefix name; lower case is not folded to uppercase. For example, queue prefixes EYUPREFIX, EYUprefix, and eyuprefix identify three different queue models. If you are using CECI, or any other application that does not support mixed case prefix names, you should check that your data is being written to the correct temporary storage queue.

Recovery option RECOVERY Specifies whether or not queues matching this model are to be recoverable.
Remote TS queue prefix REMOTEPREFIX The character string that is to be used as the prefix on the remote system. The prefix may be up to 16 characters in length.
Remote system ID REMOTESYSTEM The name of the connection that links the local system to the remote system where the temporary storage queue resides. REMOTESYSTEM and POOLNAME are mutually exclusive. If REMOTESYSTEM is specified, POOLNAME is ignored.
Security option SECURITY Specifies whether security checking is to be performed for queues matching this model.
User data area 1 USERDATA1 Optional string of up to 8 characters that allows you to provide additional site-specific data related to the BAS resource definition. This field is ignored for CICS CSD resource definitions.
User data area 2 USERDATA2 Optional string of up to 8 characters that allows you to provide additional site-specific data related to the BAS resource definition. This field is ignored for CICS CSD resource definitions.
User data area 3 USERDATA3 Optional string of up to 8 characters that allows you to provide additional site-specific data related to the BAS resource definition. This field is ignored for CICS CSD resource definitions.
Hexadecimal TS queue prefix XPREFIX An alternative to PREFIX. Enter a hexadecimal string, up to 32-characters in length, that is to be used as the prefix for this model. Because XPREFIX is specified in hexadecimal form, you can use a name that contains characters that you cannot enter in the PREFIX attribute. Generic prefix names are allowed, using a single wildcard character, hex 4E
Hexadecimal remote TS queue prefix XREMOTEPFX An alternative to REMOTEPREFIX. Enter a hexadecimal string, up to 32-characters in length, that is to be used as the prefix on the remote system. Because XREMOTEPREFIX is specified in hexadecimal form, you can use a name that contains characters that you cannot enter in the REMOTEPREFIX attribute. Generic prefix names are allowed, using a single wildcard character, hex 4E.


eyua7crm.html | Timestamp icon Last updated: Sunday, 4 June 2017