ONXLIST Output Files/Lib Elements/Jobvar. to a Print File

ONXLIST [m,] outfil [, E|O] [, TOC] [, HTML] [,Ln] [, W [c] ] [, H] [, H4] [, NN] [, RH] [, NH] [, IOH]

The contents of all files/library elements/Job variables flagged with an X will be written to the output file outfil. outfil is print-ready, and may be printed with SPACE=E.

m Only the first m records of each of the input data objects will be listed.

E The output file will be opened with OPEN=EXTEND.

O The output file will be opened with OPEN=OUTPUT. (Standard).

TOC Table of Contents. A Table of Contents will be created in the output file of all listed files/library elements. The Table of Contents will contain the names of all listed files, as well as the page on which the file begins in the output listing. The individual pages in the printable output listing will be numbered sequentially as a result of specifying TOC.

Standard: no Table of Contents in the output file.

HTML HTML-formatted Table of Contents for viewing the output file through an internet browser. The Table of Contents contains the name of the objects and an HTML hyperlink to the start of the relevant object. When using a browser, clicking on the name of the object will take the user straight to the start of the object.

Standard: no Table of Contents in the output list.

L n Number of lines per print page. n: two or three digit number.

Standard: L=64. The system administrator can set the standard value to match the value normally used in the computer centre (CFSMAIN).

W [c] Wrap. Records longer than c bytes will be continued on the following line. c is a number less than 256 which defines the last print column per line. If c is not specified, the standard value of 132 will be assumed. The system administrator can set the standard value to match that used in the computer centre (CFSMAIN).

Standard: Wrap mode not set. Each file record is displayed on a single line in the output file. An output record can be up to 2036 bytes long. When printing with SPACE=E, these records will be truncated at Column 132.

H Hexadecimal output.

The output will be analogous to that of the Display mode of CFS when a DL or H (Display Long, Hexadecimal) command has been entered, or to that of the BS2000 dump format. For each record of the output file, the 40 left-most bytes will be displayed in hexadecimal format, and the 40 right-most bytes will be displayed in character format.

Standard: No hexadecimal representation.

H4 Four line hexadecimal output.

The output will be analogous to the hexadecimal mode of EDT. Four lines of the output file are used for 80 bytes of data. Line 1 contains a ruler. Line 2 contains the character representation of the data. Lines 3 and 4 contain the most and least significant half-bytes for each byte. The position of the keys in ISAM files are indicated by displaying KK...KK in the ruler line.

Standard: No hexadecimal representation.

NN No Numbers. The records are displayed without record numbering.

Standard: With record numbering for SAM and PAM files.

NH No Header. The records will be listed without the header "FILENAME: xxxx" , nor will it contain any printer control codes.

The No Header option of the ONXLIST Variable Action can be used to concatenate multiple files into a single sequential file with attributes of FCBTYPE=SAM, RECFORM=V, BLKSIZE=(STD,1).

RH Reduced Header. A header containing the file or library and element name will be inserted at the beginning of each listed data object. The individual records will be listed without printer control information, as for NH (No Header).

IOH Insert only Header. The files to be listed will be prepared for printing. The files will be taken with the existing form control characters. CFS will insert an additional header page for each file.

Notes:

The NH / RH parameters are not evaluated in conjunction with TOC.

The W (Wrap) parameter is normally set for H and H4.

PAM files can only be listed with ONXLIST in the H or H4 mode.

When listing the contents of Job variables, the RH parameter (Reduced Header) should be used: ONXLIST outfil,RH.