Building a customized resource table record

Normally, when you create a result set, each resource table record contains the complete set of attributes in the format defined by CICSPlex SM. There might be times, however, when you want to work with a subset of those attributes or work with them in a different order. The SPECIFY VIEW command lets you decide which attributes of a resource table to include in a record and what order to present them in. In effect, you are building a temporary, custom-made resource table.

You can build views only for resource tables with a type of CICS Resource; you cannot build views for any other type of resource table. Also, a view can be built from the attributes of only one resource table at a time. You cannot combine attributes from different resource tables into a single view. You can specify the EYU_CICSNAME and EYU_CICSREL attributes in an order expression to identify the CICS® system from which a view record was collected.

When you build a resource table view, you have to give it a name. The name you assign to a view takes precedence over any existing resource table names. This means you can redefine an existing resource table name to represent a subset of the attributes in a different order than they appear in the original table.

For ease of maintenance of your programs, give unique names to your customized resource table views. If you do not use unique names, you cannot access another view with the same name in the same processing thread without the programming overhead of discarding the original view. When you upgrade your version of CICSPlex SM, check that any new resource tables do not duplicate your customized view names.

To define to CICSPlex SM which resource table attributes you want to include and in what order, you specify an order expression on the FIELDS option of the SPECIFY VIEW command. This expression is similar to the one you use when sorting records in a result set with the ORDER command. The order expression consists of a list of the attributes to be included in the view.

The syntax of an order expression for building a view is:
Read syntax diagramSkip visual syntax diagram
Order Expression – Building a View

   .-,--------.      
   V          |      
>>---+------+-+--.---------------------------------------------><
     '-attr-'        

attr
Is the name of an attribute in the resource table.

You can specify as many attribute names as you like, but the total length of an order expression, including commas and blank spaces, must not exceed 255 characters. If you do not specify an attribute name, the order expression contains the name of the first attribute in the resource table, for example, the JOBNAME attribute in the CICSRGN resource table.

For example, to build a limited view of the LOCTRAN resource table, you can specify:
  TRANID,STATUS,USECOUNT,PROGRAM,PRIORITY,TRANCLASS.

An order expression must be followed by either blank spaces or null characters to the end of the specified buffer. That is, the buffer length you specify (using the LENGTH option) must not include any data other than an order expression. Once a view is built, you can specify it on the OBJECT option of a GET command. The resource table records returned by GET include only those attributes you named in the order expression on the SPECIFY VIEW command.

Any views that you build are associated with the specific processing thread on which you build them; they cannot be shared by other processing threads. When you terminate your processing thread, any views you built on it are discarded. You can also choose to discard a view at any time by using the DISCARD command.



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