SPECIFY VIEW
Build a customized view of a given resource table.
>>-SPECIFY--VIEW--(--data-value--)--FIELDS--(--data-area--)-----> >--LENGTH--(--data-value--)--OBJECT--(--data-value--)-----------> >--THREAD--(--cpsm-token--)--RESPONSE--(--data-ref--)-----------> >--REASON--(--data-ref--)--------------------------------------><
Description
This command builds a customized
view of a given resource table.
- Views can be built only for resource tables with a type of CICS® Resource.
- Views are associated with the specific processing thread on which they are built; they cannot be shared by other processing threads.
- When a processing thread is terminated, any views built by it are deleted.
- The name you assign to a view takes precedence over any existing resource table names. You can redefine an existing resource table name to represent a customized view of that resource table.
- You are recommended to use names for customized views that are not already assigned either to other customized views or to CICSPlex® SM-supplied resource tables. If you do use a name that is already assigned, you should be aware that your processing could be affected. For more details, see Developing CICSPlex SM applications.
- When you upgrade to a later version of CICSPlex SM, you should check that any new resource tables do not have the same names as any customized views. For more details, see Developing CICSPlex SM applications.
Related commands
DISCARD, GET
Options
- FIELDS(data-area)
- Identifies a buffer containing the order expression to
be used for this operation.
For details on how to use an order expression with the SPECIFY VIEW command, see Developing CICSPlex SM applications.
Note: You cannot specify the EYU_CICSNAME or EYU_CICSREL attributes in an order expression. - LENGTH(data-value)
- A fullword value that specifies the length of the FIELDS buffer.
Note: The buffer length you specify should not include any data other than an order expression.
- OBJECT(data-value)
- Identifies the resource table for which a view is being created. This value must be the 1- to 8-character name of a valid CICS Resource table. For a list of the CICSPlex SM resource tables by type, see Developing CICSPlex SM applications.
- REASON(data-ref)
- Names a variable to receive the fullword reason value returned by this command.
- RESPONSE(data-ref)
- Names a variable to receive the fullword response value returned by this command.
- THREAD(cpsm-token)
- Identifies the API thread to be used for this operation. The cpsm-token value that identifies a thread is returned by the CONNECT command.
- VIEW(data-value)
- Defines a 1- to 8-character name for the view being built.
Conditions
The following is a list of the
RESPONSE values that can be returned by the SPECIFY VIEW command.
The description of each RESPONSE includes a list of associated REASON
values, if appropriate.
- OK
- The command completed processing successfully.
- DUPE
- A duplicate condition occurred for the following reason:
- VIEW
- The specified view already exists and cannot be built.
- ENVIRONERROR
- An environment error occurred for one of the following reasons:
- NOSERVICE
- The application stub program could not load the API service module.
- NOSTORAGE
- The application stub program could not obtain the necessary storage in the address space where the processing thread is running.
- SOCRESOURCE
- A required resource that is owned by the CMAS is not available.
- FAILED
- The command failed for one of the following reasons:
- ABENDED
- Command processing abended.
- EXCEPTION
- Command processing encountered an exceptional condition.
- INVALIDCMD
- The command is invalid for the following reason:
- LENGTH
- The total length of all the options on the command exceeds the maximum limit.
- INVALIDPARM
- An invalid parameter was detected in either the command string
or the FIELDS buffer. The parameter that is invalid is returned as
the reason value:
- ATTRIBUTE
- FIELDS
- LENGTH
- OBJECT
- THREAD
- VIEW.
- NOTAVAILABLE
- A not available condition occurred for one of the following reasons:
- APITASK
- The API control subtask is not active.
- CPSMAPI
- The CMAS to which the processing thread is connected is not available for API processing.
- NOTFOUND
- A not found condition occurred for the following reason:
- ATTRIBUTE
- An attribute specified in the FIELDS buffer was not found for the specified resource table.
- SERVERGONE
- The CMAS to which the processing thread was connected is no longer active.
- TABLEERROR
- A resource table record is invalid for one of the following reasons:
- DATAERROR
- The value associated with one or more resource table attributes is invalid. This error can occur if the resource table is missing required attributes, contains one or more conflicting attributes, or does not exist. Use the FEEDBACK command to retrieve additional data about this error.
- INVALIDVER
- The specified version of the resource table is not supported by CICSPlex SM.
- VERSIONINVL
- A version conflict occurred for one of the following reasons:
- NOTSUPPORTED
- The version of the application stub program used for this command is not supported.
- NOTVSNCONN
- The version of the application stub program used for this command is not the same as the version used with the CONNECT command.
