 |
» |
|
|
|
Some questions that you may wish to answer in this section include Does a file by this name exist in my account or group? When and by whom was this file created? What security provisions exist for this file?
You can use this information in an interactive context, or you can use commands
and intrinsics within an executing program to obtain and utilize the
information. | You use: | To obtain information about: |
|---|
| LISTFILE | Characteristics of a permanent file | | LISTFILE...;TEMP | Characteristics of a temporary file | | LISTEQ | File equations in effect for current job or session |
Displaying permanent file information with LISTFILE | |
The LISTFILE command is one of the most widely used commands in
MPE/iX. You use LISTFILE to display information about one or more
permanent files that you specify. LISTFILE has parameters that
allow you to: specify a set of permanent or temporary files that you wish information about specify the amount, or level, of file information that you wish to see specify a file where the LISTFILE output is written to
Specifying a file referenceIf you do not indicate otherwise, LISTFILE displays information
about all of the permanent files located in your logon group. You can
optionally reference a file (or files) by specifying a file name and
qualifying it with the appropriate group and/or account name. For
example, if your logon group and account are MYGROUP.MYACCT, the
following commands will return information about the same file:
LISTFILE MYFILE
LISTFILE MYFILE,MYGROUP
LISTFILE MYFILE,MYGROUP,MYACCT
|
In addition, you can use MPE/iX wildcard characters, in conjunction
with a qualified file reference, to specify a set of files you want
LISTFILE to display information about. The wildcard characters
you can use are @ = zero or more alphanumeric characters # = a single numeric character ? = a single alphanumeric character
Specifying the list levelIf you do not indicate otherwise, LISTFILE displays only the
unqualified file name. You can optionally direct LISTFILE to
display more detailed information about the file(s) that you specify,
depending upon the parameter value that you specify in the command, as listed
in Table 14-1 “Format Selection”. Table 14-1 Format Selection | Option | Name | Displayed Information |
|---|
| -2 | ACD | Displays the file's ACD (access control definition). System managers can view the ACD for any file. Account managers can view the ACD for files in that account. File creators can view the ACD for their files. Other users can view an ACD only if that ACD specifies that the user has RACD (read ACD) access.
| | -1 | LABEL | Displays the hexadecimal listing of the file label,
including all lockwords. This level is available only to system
managers and account managers. | | 0 | FILES | Shows only the file name. This is the default. | | 1 | SUMMARY | Displays the file name, file code, record size,
record format, and other
file characteristics such as ASCII or binary records, carriage-control option,
current end-of-file location, and the maximum number of records allowed
in the file. | | 2 | DISC | Displays the file name, file code, record size, record
format, and other file characteristics such as ASCII or binary
records, carriage-control option, current end-of-file location, and
the maximum number of records allowed in the file. It also displays
the blocking factor, number of sectors in use, number of extents
currently allocated, and the maximum number of extents allowed. LISTF,
2 also displays KSAM XL file types with "K".
| | 3 | DETAIL | Displays the file name, record size, extent size, number
of records, access rights for the user, and other file characteristics
including the date created, modified, and last accessed. The creator,
lockword, and label address are omitted. These can be obtained by
specifying -3 if you have AM capability (for files in your account) or
SM capability (for any file on the system).
| | 4 | SECURITY | Displays the security matrix for the file. This
includes account-, group- and file-level security and the access rights
for the user. If an access control definition exists (ACD), a message
stating that fact is displayed.
| | 5 | DATA | Shows LISTFILE,3 data and all file-specific data in LISTF, 3 type format (that is, KSAM and SPOOL). | | 6 | QUALIFY | Shows only fully qualified file name. | | 7 | UNIQUE | Shows all file specific data in LISTFILE,3 type format, but does not show LISTFILE,3 data. |
Specifying an alternate output fileIf you do not indicate otherwise, LISTFILE sends its output to
$STDLIST. You can optionally specify a different output file to
which the file descriptions are written. List all files in your logon account and group with file names that
contain the characters "INFO":
LISTFILE @INFO@
INFOABST INFOUTLN INFOPREF PSMGINFO WINFOUTQ XLINFO
|
Show the file characteristics of all files with names beginning with
"X" in a specified account and group:
LISTFILE X@.INTRIN.LOZAR
ACCOUNT= LOZAR GROUP= INTRIN
FILENAME CODE ------------LOGICAL RECORD--- ----SPACE----
SIZE TYP EOF LIMIT R/B SECTORS -X MX
XLHPCICO 80B FA 39 39 3 8 1 1
XLHPCIDE 80B FA 47 47 3 8 1 1
XLHPCIGE 80B FA 27 27 3 8 1 1
XLHPCIPU 80B FA 44 44 3 8 1 1
|
Display the label information for a specified file:
LISTFILE ODDITY,3
********************
FILE: ODDITY.INFO.LOZAR
FILE CODE : 1030 FOPTIONS: BINARY,FIXED,NOCCTL,STD
BLK FACTOR: 1 CREATOR :
REC SIZE: 256(BYTES) LOCKWORD:
BLK SIZE: 256(BYTES) SECURITY--READ : ANY
EXT SIZE: 0(SECT) WRITE : ANY
NUM REC: 7816 APPEND : ANY
NUM SEC: 0 LOCK : ANY
NUM EXT: 4 EXECUTE : ANY
MAX REC: 31250 **SECURITY IS ON
FLAGS : n/a
NUM LABELS: 0 CREATED : TUE, JUN 3, 1986, 9:47 AM
MAX LABELS: 0 MODIFIED: TUE, JUN 3, 1986, 9:48 AM
DISC DEV -: 0 ACCESSED: WED, JUN 4, 1986, 2:38 PM
CLASS : DISC LABEL ADDR: $00000010 $00004414
SEC OFFSET: 0
|
Obtain a detailed ACD report on a file:
LISTFILE FILEA,-2
FILE = FILEA ************** ACD ENTRIES **************
SAM.DOE : R
JOE.DOE : W
@.DESIGN : NONE
@.@ : X
|
Displaying temporary file information with LISTFILE...(;TEMP) | |
The LISTFILE...(;TEMP) command is similar to LISTFILE, except
that it displays information about the specified temporary files.
Syntax, parameters, and information displayed are the same as
LISTFILE, with the following exceptions: Its display of file information includes the word TEMPORARY or the
abbreviation TEMP. Displaying file equations with LISTEQ | |
The LISTEQ command allows you to list
all file equations in effect for the job or session from which you issue the
command. Here is an example of a LISTEQ call:
LISTEQ
FILE EQUATIONS
FILE LP;DEV=PP;ENV=ELITE.XQENV.SYS;CCTL
FILE OFFLINE;DEV=PP;ENV=ELITE.XQENV.SYS;CCTL
FILE EDTLIST;DEV=PP;ENV=ELITE.ENV2680.SYS
|
If you do not indicate otherwise, LISTEQ sends its output to $STDLIST. You
can optionally specify a different output file to which the file descriptions
are written. For example, the following command sends output to the temporary
file MYFILE: |
