@SHOW (format 1) - Output directory

The @SHOW statement (format 1) can be used to output a library's directory or a list of files from the BS2000 catalog or from a POSIX directory. It is possible to define the destination for the output. Optionally, it is also possible to output additional information about the files or library elements.

Operation	Operands	F mode, L mode
@SHOW	[ {LIBRARY=path1 [,[TYPE=]eltype]  | TYPE=eltype]  | FILES [=path2]  | POSIX-FILES [=xpath] } ] [ [TO] line [(inc)] ] [ { SHORT | LONG [MODDATE] } ]

LIBRARY=

The directory of a library or of an element type in a library is to be output. If
there is more than one version of an element then all the versions are
displayed. If there are no elements of the specified element type, the
message EDT5287 is output. If the specified library does not exist or cannot
be accessed as required then a corresponding message is output.

If LIBRARY (and also FILES and POSIX-FILES) is not specified then the
default library set with @PAR LIBRARY is used implicitly provided that
@PAR LIBRARY has been specified. Otherwise, the message EDT5181 is
output.

path1

TYPE=

Name of the library.

Only the directory of all the elements of a specific type should be specified.
If TYPE is not specified then the entire library directory is output.

eltype

Type of element. Permitted type specifications are S, M, P, J, D, X, R, C, H, L,
U, F, *STD and freely selectable type names having one of these types as
basic type. The permitted element types and their meanings are described
in chapter “File processing”.

FILES=

path2

A list of files from the BS2000 catalog is to be output.

Designates the files that are to be listed. The path2 operand can be a fully
or partially qualified file name, may contain wildcards and can be up to 80
characters in length.

If path2 is not specified then a list of all the files under the user's own ID is
output. If no file with the specified name is found, the message EDT5281 is
output.

POSIX-FILES=

A list of files from the POSIX directory is to be output.

xpath

Designates the POSIX files that are to be listed. If xpath is a directory then
all the files in this directory are listed (without the directory component). If
xpath is an ordinary file then its name is displayed as specified.

The xpath operand can also be specified as a string variable. It must be
specified as a string variable if the path name contains characters which
have a special meaning in EDT syntax (e.g. blanks, semicolons in F mode
or commas).

If xpath is not specified then a list of all the files in the current POSIX
directory is output. If no file with the specified name is found or if the
directory cannot be accessed as required then a corresponding message is
output.

line

Line number as of which information is to be written to the current work file.

If a line with a number greater than the previous highest line number is
created then the current line number is modified.

If line is not specified then in the interactive mode's L mode, the result is
output to SYSOUT, in batch mode it is output to SYSLST and in F mode it is
written to work file 9. Work file 9 is deleted before being used. If a file is open
in work file 9 then the message EDT5189 is output and the statement is not
executed.

inc

Increment used to form the line numbers which follow line. If inc is not
specified then the increment implicitly specified by line is used (see
section “Implicit increment assignment”).

SHORT

This is the default value for handling information output. The meaning of
SHORT is different for the individual file types.

In the case of libraries, every element is output:

Column	Header	Meaning
2–5	TYP	Element type
7–38	ELEMENT	Element name
42–53	VERSION	Version designation or @ for the highest possible version
56–59	VAR	Variant number
63–72	DATE	User date (format YYYY-MM-DD)

The list is alphabetically sorted on the type names, element names and
version names. In the case of type names > 4, element names > 32 or
version designations > 12 characters, entries consist of 2 lines.

If the output is sent to SYSOUT or SYSLST then it is accompanied by a header
(see table). If the output is sent to work file 9 (in F mode, without the line
operand) then the header is output in the information line (can be displayed
using @PAR INFORMATION=ON). If the output is written to a work file due
to the line operand then no header is output.

In the case of BS2000 files, one file is output per line. Only the extended file
names together with the catalog ID and user ID, are output. The list is
alphabetically sorted on the file names.
No header is displayed.

In the case of POSIX files, one file is output per line. Only the file names are
output. The list is alphabetically sorted on the file names. No header is
displayed.

LONG

Additional information is output for the files. The meaning of LONG is
different for the individual file types.

In the case of libraries, a line with the following content is output for every
element:

Column	Header	Meaning
1-8	TYP	Element type
10-73	ELEMENT L=path1	Element name
75-98	VERSION	Version designation or @ for the highest possible version
100-103	VAR	Variant number
105-114	DATE	User date or date of last modification (format YYYY-MM-DD)
116-123	CODESET	Character set

The list is alphabetically sorted on the type names, element names and
version names.

If the output is sent to SYSOUT or SYSLST then it is accompanied by a header (see table) which includes the name of the library. If output is written to work file 9 (in F mode, without the line operand) then the header is output in the information line (can be displayed using @PAR INFORMATION=ON). If the output is written to a work file due to the line operand then no header is output.

In the case of BS2000 files, a line with the following content is output for
every file:

Column	Header	Meaning
1-10	SIZE	Number of PAM pages
11	P	File on private or public data medium (*/'BLANK')
12-65	FILENAME	File name with CATID and USERID
67-76	LAST PP	Last used PAM page
78-87	CR-DATE or MOD-DATE	Creation date or date of the last modification (format YYYY-MM-DD)
89	S	SHARE attribute (Y/N/S)
90	A	ACCESS attribute (W/R)
92-95	FCB	FCB type (SAM/ISAM/PAM/BTAM/NONE)
97	R	READ-PASS attribute (Y/N)
98	W	WRITE-PASS attribute (Y/N)
100-107	CODESET	Character set

The list is alphabetically sorted on the file names.

If the output is sent to SYSOUT or SYSLST then it is accompanied by a header
(see table). If the output is sent to work file 9 (in F mode, without the line
operand) then the header is output in the information line (can be displayed
using @PAR INFORMATION=ON). If the output is written to a work file due
to the line operand then no header is output.

In the case of POSIX files, a line with the following content is output for
every file:

Column	Header	Meaning
1	T	Type (D for directory, L for symbolic link, B for device file (block), C for device file (character), M for file with distributed access, P for FIFO, S for semaphore file or F for file)
2-10	ACCESS	Access rights (RWX for user, group, others)
12-31	SIZE	Size of file in bytes
33-42	MOD-DATE	Date of last modification (format YYYY-MM-DD)
44+	FILENAME	File name (case-sensitive)

The list is alphabetically sorted on the file names.

If the output is sent to SYSOUT or SYSLST then it is accompanied by a
header. If the output is sent to work file 9 (in F mode, without the line
operand) then the header is output in the information line (can be displayed
using @PAR INFORMATION=ON). If the output is written to a work file due
to the line operand then no header is output.

MODDATE

In the case of BS2000 files, the date of the last modification is output instead
of the creation date. The date format is unchanged. MOD-DATE is output in
the header.
In the case of libraries, the date of the last modification is output instead of
the user date.

In the case of POSIX files, this operand is ignored.

Output to SYSOUT or SYSLST is sent in the character set that has been defined for these system files.
If the output is written to a work file then it is sent in the work file's character set. If the work file is empty and has the character set *NONE then the character set EDF041 is used. Characters that cannot be displayed in the target character set are always replaced by blanks.

Example

The entire directory of the library EDT.LIB.XMPL is to be output in the current work file starting at line number 100 and using the increment 10.

Detailed information on all the BS2000 files whose names contain the string TEXT is output in work file 9. EDIT LONG is specified to make it possible to view the information in full in the data window.

Detailed information about the POSIX file “data” in the current POSIX directory is output in work file 9. EDIT-LONG mode is deactivated again.