Brief catalog listing

Displayed catalog information

In the following examples, each field displayed is identified by a number which makes reference to the associated comment. The display differs according to the CONTENT and NPART selection parameters.

The following is indicated at the end of the display of the characteristics of the selected catalog entries:

  • The number of entries whose characteristics are displayed (n)
  • The total number of entries recorded in the catalog at the time the LISTCAT command is processed (p)
  • The number of catalog entries still free (q) and the percentage of space still free (r%)

This information is displayed in the following form:

  • n records selected
  • p records in catalog file
  • q records free (r%)

For LISTCAT CONTENT = BRIEF, NPART = {identifier | mask}

LISTCAT CONTENT = BRIEF, NPART = { identifier | mask}

1          2             3              4                5                    6                     7

Date = DD-MM-YYYY, Time = hh:mm

Partner DTSA File Transfer Diags Parm

Network Name) Id. Id.                                   CFT Prot.

xxxxxxxxxxxxx xxxx xxxxxx xxxxxx     xxx  xxxxxx  xxxxxxxxxxxx

xxxxxxxxxx   xxxx   xxxxxx   xxxxxx       xxx  xxxxxx   xxxxxxx

xxxxxxxxx   xxxx   xxxxxx   xxxxxx      xxx  xxxxx   xxxxxxxxxxx

The following table contains the comments associated with the various headings contained in this figure.

LISTCAT CONTENT - BRIEF, NPART - Headings comments

Heading Description

Partner network identifier.
The partner network name corresponds to the NRPART parameter of the CFTPART command and has a length of 16 characters only. 

Transfer state
The characters DTSA mean:

  • Direction = S/R (Send/Receive)
  • Type = F/M/R (File/Message/Reply)
  • State = D/C/H/K/T/X (Disp/Current/Hold/Keep/Terminated/eXecuted)
  • Ack = A (Acknowledge)

File identifier (IDF) for a file transfer or message identifier (IDM) 

Transfer identifier. Transfer identifier assigned by the Transfer CFT (IDT) 

Transfer CFT internal diagnostic code
For a transfer with an error, this field is defined with the Transfer CFT internal diagnostic code (DIAGI) relative to this error
For a correctly terminated transfer, this field is set to zero (1) 

Protocol diagnostic code
If the entry concerned is not a generic entry:

  • for a transfer with an error, this field is defined with the protocol diagnostic code (DIAGP) relative to this error (2)
  • for a correctly terminated transfer, this field indicates the compression factor obtained which is documented as follows:
    • CP NONE: transfer correctly terminated with no "on line" compression requested
    • CP xx%: transfer terminated correctly with a compression factor of xx%
  • for a delayed transfer, this field is defined with:
    • hh:mm:ss: if sent the same day
    • dd/mm/yy: if sent the following days

 

If the entry concerned is a generic entry, this field is defined with one of the following values:

  • RECV ALL: generic entry for a global reception request for all the files with a given IDF
  • RECV MSK: generic entry for a global reception request for IDFs with "wildcards"
  • MIN CYC: generic entry for cyclic transfers, period expressed in minutes
  • DAY CYC: generic entry for cyclic transfers, period expressed in days
  • MON CYC: generic entry for cyclic transfers, period expressed in months
  • DIFFUS: generic entry for a broadcasting
  • COLLECT: generic entry for a collection

PARM field
This field is 24 characters long and may be truncated as required 

(1) (2): Refer to Codes Diagnostics and Messages .

For LISTCAT CONTENT = BRIEF, PART = {identifier | mask}

The NPART parameter is not defined.

LISTCAT CONTENT = BRIEF, PART = { identifier | mask}

1            2             3               4               5                   6                7            8                         9

Date = DD-MM-YYYY, Time = hh:mm

Partner DTSA     File           Transfer               Records            Diag   Diag Applic.

                      Ident         Ident           Transmit     Total                    Protocol   Ident

xxxxxxx   xxxx   xxxxxxxx   xxxxxxxx  nnnnnnnn nnnnnnnn   nnn   xxxxxxxx   xxxxxxxx

xxxxxxxx   xxxx   xxxxxxxx   xxxxxxxx  nnnnnnnn nnnnnnnn   nnn   xxxxxxxx   xxxxxxxx

xxxxxxx   xxxx   xxxxxxxx   xxxxxxxx   nnnnnnnn nnnnnnnn   nnn   xxxxxxxx   xxxxxxxx

The following table contains the comments associated with the various headings contained in this figure.

Heading Description

Identifier of the partner described in the commands CFTPART (corresponding to the ID parameter) or CFTDEST (one of the PART in the broadcasting list) 

Transfer state description
The DTSA characters mean:

  • Direction = S/R     (Send/Receive)
  • Type = F/M/R     (File/Message/Reply)
  • State = D/C/H/K/T/X     Disp/Current/Hold/Keep/Terminated/eXecuted)
  • Ack = A     (Acknowledge)

File identifier (IDF) for a file transfer or message identifier (IDM). 

Transfer identifier (IDT) 

If the transfer involves:

  • a file: number of records to be sent
  • a message: message text truncated to 21 characters

If the transfer involves:

  • a file: number of records sent
  • a message: remainder of the message text truncated to 21 characters

Transfer CFT internal diagnostic code
For a transfer with an error, this field is defined with the Transfer CFT internal diagnostic code (DIAGI) relative to this error
For a correctly completed transfer, this field is set to zero (1) 

Protocol diagnostic code
If the entry concerned is not a generic entry:

  • for a transfer with an error, this field is defined with the protocol diagnostic code (DIAGP) relevant to this error (2)
  • for a correctly completed transfer, this field indicates the obtained compression factor which is documented with the following format:
    • CP NONE: transfer terminated correctly with no "on line" compression requested
    • CP xx%: transfer terminated correctly with a compression factor of xx%
  • for a delayed transfer, this field is defined with:
    • hh:mm:ss: if sent the same day
    • dd/mm/yy: if sent the following days

If the entry concerned is a generic entry, this field is defined with one of the following values:

  • RECV ALL: generic entry for a global receive request for all the files with a given IDF
  • RECV MSK: generic entry for a global receive request for IDFs with "wildcards"
  • MIN CYC: generic entry for cyclic transfers, period expressed in minutes
  • DAY CYC: generic entry for cyclic transfers, period expressed in days
  • MON CYC: generic entry for cyclic transfers, period expressed in months
  • DIFFUS: generic entry for a broadcasting
  • COLLECT: generic entry for a collection

Identifier of the application (IDA) associated with this transfer 

  (1) (2): See Codes Diagnostics and Messages .

Related Links