Listing catalog contents

This topic describes how to list the catalog contents using command line operations. The LISTCAT command is used to query the information associated with the selected transfers, recorded in the Transfer CFT catalog.

Depending on the value of the CONTENT parameter, the information is displayed in the form of:

  • Lists in which only the most important features of transfers appear CONTENT = BRIEF default value
  • Pages in which all the features of transfers appear CONTENT = FULL

In the absence of a previous command CONFIG TYPE = OUTPUT, this information or the execution report for a syntax error, no associated information, and so on, is written on the standard output of the task.

This command is used to display output for:

  • Static transfer information associated with the parameters of the SEND and RECV commands
  • Dynamic transfer information such as the:
  • Transfer status
  • Number of items transferred
  • Compression factor, etc

The command parameters are selection criteria.

Command syntax: LISTCAT

For the definition of the states of a transfer, refer to Transfer control commands .

Description

Use this command to query the information associated with the selected transfers, recorded in the Transfer CFT catalog.

Parameters

CONTENT 

Used to obtain part or all of the information of a catalog entry.

DIAGI Define the diagi catalog transfer field display.

DIRECT 

Transfer direction.

The possible values are:

  • BOTH
  • SEND
  • RECV

FILE = see the comment

Complete name or logical name of the catalog file.

The default value for this parameter is fixed.

To designate the current catalog of the monitor, this parameter should be defined with the filename set in the FNAME parameter of the CFTCAT command.

IDA 

Local identifier of the transfer assigned by the user or the user application.

Several catalog entries may be associated with a given IDA.

IDF 

Model file identifier.

Several catalog entries may be associated with a given IDF.

IDT 

Transfer identifier.

Identifies a transfer for a given partner and transfer direction.

IDTU 

Unique local transfer reference identifier.

NPART 

Network identifier of the partner(s) for the selected transfers.

The information displayed for LISTCAT CONTENT = BRIEF is different, according to whether the NPART parameter is defined or not (see the paragraphs below).

PART 

Partner identifier for the selected transfers.

The value of this parameter may be:

  • An identifier
  • A mask
  • Omitted*

If the NPART parameter is defined, the PART parameter is ignored.

STATE

Possible states of a catalog entry .

The catalog entries in the state indicated by this parameter are selected. Any combination of the various states (D,C,H,K,T,X) is authorized.

TYPE 

(Mandatory)

Type of catalog entry.

If TYPE = ALL, no selection is made: all transfers present in the catalog (files, messages, reply messages) are displayed if they fulfill the selection criteria which may be defined by other parameters.

Example 1:

LISTCAT TYPE =  ALL, PART = HQ, STATE = DC

Displays the most important information (CONTENT=BRIEF by default) concerning all transfers (TYPE=ALL) sent to or received from (DIRECT=BOTH by default) the partner (PART = HQ), the states of which are "Available" or "in Process" (STATE=DC).

Example 2:

LISTCAT

 

TYPE = FILE, DIRECT = SEND, PART = PARIS5

 

Displays the most important information (CONTENT=BRIEF by default) concerning the file transfers (TYPE=FILE) sent (DIRECT=SEND) to the partner (PART) PARIS5, all states included (STATE=* by default).

LISTCAT CONTENT = COMMUT

LISTCAT CONTENT = COMMUT

Heading Meaning

Intermediate transfer (IPART) 

State transfer
The DTSA characters represent:

  • 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)
Note If the UCONF compatibility option is set to the default value (no), the format is DTSAPP to include Phase and PhaseStep. For more information, see Backward compatibility.

File network identifier (NFNAME) 

Transfer protocol identifier (NIDT) 

Local transfer identifier (IDTU) 

Transfer CFT internal diagnostic code (DIAGI) 

LISTCAT CONTENT = EXTEND

LISTCAT CONTENT = EXTEND 

Heading Meaning

Local partner identifier described in the CFTPART (ID) or CFTDEST command (one of the PARTS of the broadcasting list) 

Transfer state
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)
Note If the UCONF compatibility option is set to the default value (no), the format is DTSAPP to include Phase and PhaseStep. For more information, see Backward compatibility.

File identifier (IDF) 

Transfer identifier (IDT) 

Identifier of the application associated to the transfer (IDA) 

Requester ("R") or server ("S") mode 

Client security mode ("C") or server ("S") mode 

Exits used
The characters F3AT represent:

  • F : file exit ("x" if present)
  • A : directory exit ("x" if present)
  • T : end of transfer exit ("x" if present)

Use of an end of transfer procedure ("x" if present) 

10 

Transfer CFT internal diagnostic (DIAGI) 

Related Links