DISPLAY - Catalog output display model

The DISPLAY command is an enhanced version of the LISTCAT command and displays the catalog transfer field values. The output can be organized by columns when the mode is column, or by lines when the mode is line.

Display uses an external XML file that lists and describes the format for customized models. This means the Display command can call an XML document as a fmodel parameter.

In column mode, an adjustable title bar is displayed at the top of the catalog content to improve readability. In line mode, every line is presented horizontally in the form FIELD_NAME = FIELD_VALUE. Several customizing options are available in both modes to control the display format for field values such as prefix, suffix, length, and alignment. The line output can also be customized by prefix and suffix.

DISPLAY uses the same parameters as the LISTCAT command and, with the exception of the CONTENT parameter, all common parameters use the same semantics. However, there are certain parameters that are applicable only for the DISPLAY command, as described further on in this topic.

The use of the DISPLAY command overrides all other global model options. Parameters that are affected by this command are MODE, NA and EMPTY.

About XML

The XML formatting must comply with certain conventions:

  • The file must begin with the header: <?xml content='ascii'?>
  • Every tag <tag> must be closed </tag>
  • Using a tag in the format <tag/> is accepted but not recommended and should be empty

For more information, refer to an XML standards reference such as http://www.w3.org/TR/REC-xml/. Additionally, you can reference the sample template delivered with your Transfer CFT, which is located in the OS-specific distribution package:

  • UNIX, Windows: DSPCNF.XML in runtime/conf
  • z/OS (MVS): distlib.XMLLIB(DSPCNF) and instance.XMLLIB(DSPCNF)
  • IBM i (OS/400): CFTPGM/DSPCNF

Details

Command syntax: DISPLAY

Description

Use this command to displays the catalog transfer field values organized either by columns (mode=column) or by lines (mode=line).

Parameters

CONTENT

Select the model to use.

DIAGI

Define the diagi catalog transfer field display:

  • DIAGI=0: select transfers that have a DIAGI=0
  • DIAGI=ERROR: select transfers that have a DIAGI other than 0
  • DIAGI=* : select all transfers (default value)

FMODEL

Complete name or logical name of the XML model file.

This parameter default value is fixed. 

FOUT PeSIT

You can extract Transfer CFT messages from the Catalog file, and forward these messages to a specified file using the fout parameter.

The message length for PeSIT ANY profile, when forwarding a message from one CFT to another, has increased from 512 to 4096 bytes. The S/RRUSIZE must be greater than the maximum message length and message information combined (for example, 4127).

The parameter fout enables you to redirect output to a specified file.

MODE

This parameter is used to force the output mode of a model.

Two modes are available:

The COLUMN mode: this mode outputs the catalog fields in columns with a title bar (see LISTCAT CONTENT=BRIEF ) the LINE mode: this mode outputs the catalog fields with one field by line prefixed by its title.

The default value ANY means that the mode is specified in the model. The default mode used will be COLUMN if not defined in the model either.

NA

Use this parameter to replace the default output of "Non Applicable" values.  

A Non Applicable value is a value that does not mean anything for the concerned transfer. For instance, the message content field doesn't mean anything for a file transfer, so the NA string will be displayed instead.

The default string 'ANY' means that the NA is specified in the model. The default NA used will be '#'  if not defined in the model either.

EMPTY

Use this parameter to replace the default output of Empty values, usually empty string values.

The default string ANY means that EMPTY is specified in the model. The default EMPTY used is '-' if it is not defined in the model.

RUSER

Displays value as defined in the CONTENT parameter.

SORTBY

Use this parameter to display information in an alphabetical/alphanumberic order. For example, to sort by partner name and identifier, enter:

CFTUTIL DISPLAY SORTBY=(PART,IDF)

SUSER

Displays value as defined in the CONTENT parameter.

HELP

Displays help information:

  • FIELDS: Output all the fields name available for display model creation
  • MODELS: Output all the models available in the current model file

Examples

Example 1: Displays all the fields described in listcat model concerning all transfers.

DISPLAY     CONTENT = listcat

 

Example 2: Displays all the fields described in 'listcat' model concerning all transfers. The COLUMN mode is overridden by the LINE. Moreover, every invalid field value is replaced by the string '####', and every empty field value is replaced by the string '<empty>'.

DISPLAY    MODE = LINE,

 NA = '####',

 EMPTY = '<empty>'

Example 3: This shows an example of a display model file.

<?xml content='ascii'?>

<!-- LISTCAT Model : classical CFTUTIL LISTCAT with long IDs -->

<CFTDisplayFilter id           = 'listcat' title_align  = 'right'>

<Fields>

<Field id='PART' title='Partner' />

<Field id='DIRECT' title='Direction' maxlength='1' suffix='' />

<Field id='TYPE' title='Type' maxlength='1' suffix='' />

<Field id='STATE' title='State' maxlength='1' suffix='' />     

<Field id='ACK' title='Ack' maxlength='1'/>

<Field id='IDF' title='IDF' minlength='4' />

<Field id='IDT' title='IDT' />

<Field id='IDTU' title='IDTU' />

<Field id='BLKNUM' title='BLK' />

<Field id='NREC' title='Transmited' align='right' /> <Field id='FREC' title='Total' align='right' />        <Field id='MSG'         title='Msg'     maxlength='32' align='center'/>

<Field id='DIAGI'     title='Diagi' />

<Field id='DIAGP'     title='Diagp' />

<Field id='REQUSER' title='User' />

<Field id='REQGROUP' title='Group' />

<Field id='IDA'       title='IDA' /> </Fields></CFTDisplayFilter>

The output for this command would resemble the following:

Partner    DTSA IDF IDT IDTU  BLK Transmited Total  Msg  Diagi Diagp  User Group IDA

NEWYORK SFT- TEST1  D1217250 00000001 29  #   0  CP 29% user1 group1 -

PARIS    RFT- TEST1  D1217250 00000002 30  2   2    #   0     CP 29% -     -      -

PARIS    SFT- TEST2  D1217251 00000003 31  2   2    #   0    CP 29% user1 group1 -

NEWYORK RFT- TEST2  D1217251 00000004 32  2   2    #   0     CP 29% -   -  -

PARIS   SMT- MESSAGETEST1 D1217261 00000005 33 # # test message 1 0 - user1 group1 -

NEWYORK RMT- MESSAGETEST1 D1217261 00000006 34 # # test message 1 0 -   -  -      -

NEWYORK SMT- MESSAGETEST2 D1217263 00000007 35 # # test message 2 0 - user1 group1 -

PARIS    RMT- MESSAGETEST2 D1217263 00000008 36 # # test message 2 0 -  -  -     -

Related Links