Commands LISTFILE thru =LOGON

Specifies the set of files to be listed. The default for fileset is @, meaning all MPE-named files in your current working directory (CWD). If fileset includes more than one file, be sure to separate the file names with commas and enclose the set in parentheses, for example:

 :listfile (test1,test2,test3)

The files named in the fileset parameter can be either in MPE or HFS syntax (explained below). The file names dot (.) and dot-dot (..) have special meaning, that is, current directory and the parent of the current directory, respectively.

Using Wildcards

You may use wildcard characters in any position in the file name. You may use the - character as a wildcard in any position except as the first character of the file name. These wildcards have the following meaning:

For example, "[a-c]" means one of 'a', 'b', or 'c', whereas "[-a-c]" or "[a-c-]" means one of 'a', 'b', 'c', or '-'.

It is illegal to specify [c-a], or [a-A] because 'c' does not alphabetically precede 'a' and uppercase 'A' comes before lowercase 'a' (in ASCII character evaluation). Also note that it is legal to specify [A-z] and any legal special characters.

MPE Syntax

If fileset does not begin with the dot or slash (indicating HFS syntax), it is parsed according to MPE syntax and has the following form:

 filename[.groupname[.accountname] ]

A LISTFILE command using MPE syntax does not display files that do not follow the traditional MPE naming conventions of up to eight character names for files, groups and accounts.

If the fileset parameter does not specify groupname, all the files (with uppercase names that have up to 8 alphanumeric characters) in the current working directory (CWD) are listed irrespective of whether CWD is an MPE group or not. For example, the following command lists the files in all of the groups of the logon account:

 LISTFILE @.@

In contrast, the next command lists all the files in the CWD (which may be different from the logon group). However, only those files whose names are valid MPE names are displayed.

 LISTFILE @

If the CWD is not an MPE group, the information about the file is displayed in an HFS format discussed below.

You may have an MPE group that also contains files with HFS syntax, for example, they are lowercase, have long names, or contain special characters. To see both MPE and HFS files in a group, type,

 LISTFILE ./@

HFS Syntax

If the fileset begins with a dot (.) or a slash (/), it is assumed to be in HFS syntax. The characters composing the name may be selected from the following set:

 a-z
 
 A-Z
 
 0 1 2 3 4 5 6 7 8 9 - _ . ' ~ $ % ^ * + \ { } :

If the fileset parameter begins with a slash (/), the pathname is assumed to be an absolute pathname; otherwise, it is considered to be CWD relative.

If fileset ends in a slash, it is treated as a directory name, and pattern is used to determine the file names that match. All the directories and files that match fileset are found, and searched recursively to display the files and directories that match pattern. For example, if fileset is /SYS/@/, all files and subdirectories within SYS, and all files and directories within those subdirectories are displayed. The default for pattern is @.

If fileset does not end in a slash, all of the files that match fileset are displayed. For example, if fileset is /SYS/@, you will see a list of all files, subdirectories and groups in the SYS directory, but not any files or subdirectories within those directories.

If you have specified TREE, a trailing slash is assumed at the end of the fileset. For example, the command LISTFILE /SYS/@;TREE behaves like LISTFILE /SYS/@/. On the other hand, if you specify NOTREE, the trailing slash, if present at the end of a fileset, is ignored. Hence, the command LISTFILE /SYS/@/;NOTREE behaves like LISTFILE /SYS/@.

A format selection. This parameter has no effect on the files selected for display, but affects the selection of information about the files that you see. If fileset begins with a dot (.) or slash (/), or if the CWD is different from your current MPE group, or if you specify the ;TREE option, then you will see the HFS output style. This, in part, means that:

A selection equation. Use the selection equation as a filter on fileset. From the set of files matching the fileset, only files that match the select_eq requirements are listed. You may select file types by using the FTYPE option, or you may select object types by using the OBJECT option. Selection equations have the following format:

 [FTYPE = KSAMXL | SPOOL | KSAM64]
 [OBJECT = ACCT | GROUP | FILE | DIR | HFSDIR | SYMLINK]
 [CODE = number | |mnemonic | |PRIV 
 [ACCESS = INUSE | OPEN | LOCK| EXCL]

You must enclose selection equations in square brackets. For example:

 LISTFILE ./@ ;SELEQ=[OBJECT=DIR]

You can also use your text editor to make a file that contains the OBJECT or FTYPE statement, for example [OBJECT=DIR], and save it with a filename. Thereafter, you can select this file by entering the following command:

 LISTFILE ./@ ;SELEQ=^FILENAME

The OBJECT option applies to HFS files, and may have any one of the following values.

When POSIX syntax is used in the fileset, pattern is exactly the same as the filename components of fileset as previously described. The name parameter applies only to HFS syntax.

The LISTFILE command displays only those file names which match the pattern. For example,

 LISTFILE /SYS/;NAME=OFF@

displays all the files/groups/directories under the SYS account that start with OFF, off, Off, and so on.

If pattern is specified within single or double quotes, it is case sensitive. For example,

 LISTFILE /SYS/;NAME=`OFF@'

displays all the files/groups/directories under the SYS account that start with OFF. It will not display names that start with off, Off, and so on. The default for the pattern parameter is @; that is, it matches all names without regard to case.

	NOTE: You cannot use the NAME parameter for an MPE fileset because pattern can be specified as the part of the fileset. So, for example, instead of entering the command LISTFILE @.@.@;NAME=@DOC, enter the command LISTFILE @DOC.@.@. instead.

The PASS option displays sensitive data. Using it depends on your access rights to the data; that is if you are the owner or have AM or SM capability.

The PERM option displays permanent files only. "PERM'' is the default.

The TEMP option displays temporary files only.

The PERMTEMP option displays both permanent and temporary files. The permanent files are listed before the temporary files.

The USENAME option applies only to HFS-named filesets. This option indicates that the name is to be used to determine how many levels to display. If the fileset ends in a slash (/), then all files at all levels below the target file are displayed. If the name does not end in a slash (/), then only the files at the specified level are displayed. For example, /@/@/@ indicates that all objects at the third level are to be displayed. USENAME is the default.

If the TREE option is specified, objects at all lower directory levels are displayed.

Indicates that only objects at the specified level are to be displayed. The NOTREE option overrides an HFS fileset that ends in a slash.

LISTF, PLISTF (UDC), LISTFTEMP, LISTSPF (for spool files), FINDFILE (UDC), FINDDIR (UDC), LISTDIR (UDC)

None

Specifies the set of temporary files to be listed. The default is @, producing a listing of all temporary files. You may select the temporary file(s) to be listed by using the fully qualified form for fileset:

 filename[.groupname[.accountname]]

Use the # symbol to specify a single numeric character. Use the ? symbol to specify a single alphanumeric character. Use the @ symbol to specify one or more alphanumeric characters. By itself, @ represents all the members of a set.

Refer to appendix G for examples of using wildcard characters.

Specifies the level (amount and format) of information about the temporary file(s) you select. The default is zero.

The following Table 8-2 “List Options” displays the listlevel options available.

The number of sectors allocated for the file on disk. This number is always a multiple of 16 (the page size in MPE/iX). This value is an indication of the size of the file.

Number of extents. This number is displayed only to maintain compatibility with MPE V/E. This value does not indicate the size of the file. The variable-extent structure of MPE/iX permits a file to have a variable number of extents, all of variable size.

Maximum number of extents. This number is displayed only to maintain compatibility with MPE V/E. If the value is greater than 32 (the limit on MPE V/E), then * is displayed.

The name of the output file. The default is $STDLIST. If you specify listfile, it is automatically created as a new ASCII file with variable-length records, closed in the temporary domain, and with user-supplied carriage-control characters (CCTL), OUT access mode, and EXC (EXCLUSIVE access) option. All other characteristics are the same as they would be with the FILE command default specifications.

LISTF, LISTFILE, SAVE

None

Specifies the set of groups to be listed. For account managers (AM) and system managers (SM), the default is all (@) groups within the user's logon account; for general users, the default is the logon group. You may use wildcard characters to specify more than one group. Use the ? symbol to specify a single alphanumeric character Use the # symbol to specify a single numeric character. Use the @ symbol to specify all combinations of valid characters. You may also specify group.account if you have system manager (SM) capability.

The name of the output file. The default is $STDLIST, a temporary file that cannot be overwritten by a BUILD command. It is automatically specified as a new ASCII file with variable-length records, closed in the temporary domain, and with user-supplied carriage-control characters (CCTL), OUT access mode, and EXC (EXCLUSIVE access) option. All other characteristics are the same as they would be with the FILE command default specifications.

Permits users with AM and SM capability to see the group password.

Used to specify one of several display formats.

ALTGROUP, LISTACCT, LISTUSER, NEWGROUP, PURGEGROUP LISTFILE

Performing System Management Tasks

NEWJOBQ, SHOWJOB, PURGEJOBQ, SHOWJOB; JOBQ

The specific logging identifier to be verified. Default is to list all currently active logging identifiers on the system.

Causes the password associated with the logging identifier to be displayed. This option can be used only by the creator of the logging identifier.

ALTLOG, CHANGELOG, GETLOG, LOG, OPENLOG, SHOWLOGSTATUS, RELLOG

User Logging Programmer's Guide

Specifies the range of commands to be displayed. Table 8-3 “History Stack Ranges” illustrates the effect of various START or END definitions.

Displays the commands in their relative sequence (from -m to -1), where -1 denotes the most recent command in the stack.

Displays the commands in their absolute order (the order in which they were entered). ABS is the default.

Suppresses numbering of the commands during display.

Sends the listing to a disk file named outfile instead of to the default, $STDLIST. New disk files are created TEMP. File equations are ignored, unless outfile is preceded by an asterisk (*). You must use a file equation to overwrite a permanent file.

DO, REDO

Using the HP 3000 Series 900: Advanced Skills

One or more spool file IDs: #Innn for input spool files or #Onnn for output spool files. These IDs are assigned by the spooling subsystem at spool file creation time. The # is optional; but if it is used, an O or I must also be used. If it is not used, the O is also optional for output spool files; that is, if neither [#]O nor [#]I is specified, then [#]O is assumed.

A user with SM or OP capability or a console user who specifies O@ will see all output spool files on the system. A user with AM capability who specifies O@ will see all output spool files created by users in the same account. All other users are limited to files they have created. Similar rules apply to I@ and @. The default is all the output spool files created by the current user.account. The default SPOOLID for the console user is all the output spool files on the system.

The selection equation is used as a filter on the set of spool files selected. Only spool files whose attributes satisfy all filter requirements will be listed.

When you use a selection equation, enclose the entire equation in square brackets, and enclose individual keyword specifications (such as PAGES<100) in parentheses. For example, you use the following command to display all the output spool files from user.acct that have less than 100 pages:

 LISTSPF O@;SELEQ=[(OWNER=user.acct)AND(PAGES<100)]

If you are not an SM, OP, AM, or console user, the following command displays all the output files in your default group with a priority greater than 2 that were created before September 30, 1994.

 LISTSPF O@;SELEQ=[(PRI>2)AND(DATE<09/30/94)]

Selection equations have the following format. The symbol ::= should be interpreted as "can be replaced by".

select-eq ::= [equation]

In a selection equation, the logical operator AND takes precedence over the logical operator OR. For example, suppose you enter the following command:

 LISTSPF O@;SELEQ=[FILEDES=REPT OR OWNER=BOB.ACCTG AND PRI>8]

In this example, the selection equation [FILEDES=REPT OR OWNER=BOB.ACCTG AND PRI>8] is the same as [FILEDES=REPT OR (OWNER=BOB.ACCTG AND PRI>8)].

value ::= Appropriate values per data type. For example, STATE=READY or PRI>6.

parm ::= The parameter (parm) may be one of several attributes of the spool file, used as filters. The parm choices are described below.

The indirect_file parameter specifies the name of a file containing the selection equation. It must be preceded by a caret (^). The selection equation contained in the file may not exceed 509 characters in length, including the brackets in which it must reside. There is no restriction on the indirect file code. If the record size exceeds 509, only 509 characters per record are read and a warning is issued. Backreferencing to a formal file designator is also allowed for an indirect_file name; that is, ^*filename is allowed. Any file is accepted as an indirect_file, unless the file system returns an error from FOPEN or FREAD.

There is no limit to the number of records in the indirect_file, only the total character count.

Records are processed as follows:

Produces a two-line description of the specified spool file(s). The default is a one-line display (not detailed).

By default, LISTSPF displays a listing of selected spool files, followed by a statistical summary of those spool files, known as the status display.

Specification of the STATUS option causes only the status summary to be displayed summarizing the specified fileset. STATUS and DETAIL cannot be specified together.

The unique spool file identifier.

The job or session identifier of the job or session that created the spool file. The exception to this is that the jobnum for a JOB input spool file is the job number assigned the process whose $STDIN is (or will be) this input spool file, as opposed to the jobnum of the process that streamed the job. Job numbers containing an apostrophe (i.e., J'123) indicate that the spool file was imported by SPFXFER, RESTORE, or was recovered after a START NORECOVERY.

The formal or actual file designator for the spool file. Printing to a file equation such as FILE EPOCLONG;DEV=EPOC;ENV=LP88LONG.HPENV.SYS creates spool files whose formal designator is EPOCLONG.

The LDEV, device name or device class name that is the destination of the spool file. LDEVs are intentionally displayed with leading zeroes to simulate a device name. When you specify LDEVs with SELEQ, you need not supply the leading zeroes.

The input or output priority of the spool file.

The total number of copies of the spool file to be printed.

The current state of the spool file. READY and DELPND apply to input spool files as well as output spool files.

The column under each letter R, S, P, F, and N, contains the respective letter as a flag indicating something about the spool file described in that row.

This is the fully qualified name of the creator of the spool file.

An 8-character display, the first of which is a letter. If an F appears in the RSPFN column but this field is blank, it means that the file has a forms message but formid was not specified.

The job or session name of the user who created the spool file or, for a job input spool file, the name of the job that will use the input spool file as its $STDIN file..

The number of copies of this file that remain to be printed, including any currently printing copy.

The number of sectors occupied by the spool file.

The number of records in the spool file.

The number of physical pages in the spool file. This quantity is accurate only for CIPER protocol, 2680/88 page printers, and HP5000/F1xx page printers, and then only if the device has printed at least one complete copy. The device keeps track of the pages as they are printed and returns the correct count at the end of the copy. Until the actual count is known, an approximate count calculated as number_of_records ÷ 60, and denoted by a leading tilde (~) is displayed.

For serial printers, even the count without the tilde is approximate because it is calculated as a best guess from the spool file data. It is not returned by the device because serial printers have no provisions for reporting this information.

The date that the file first entered the READY state (mm/dd/yy).

The time that the file first entered the READY state in 24-hour form (hh:mm).

The status display has the following format:

 INPUT SPOOL FILES      OUTPUT SPOOL FILES
 ACTIVE  = 1;        CREATE  = 2;    READY  = 3;
 OPEN   = 2;        DEFER   = 1;    SELECTED = 4;
 READY  = 3;        DELPND  = 0;    SPSAVE  = 1;
               PRINT   = 1;    XFER   = 0;
               PROBLM  = 0;
 
 TOTAL IN FILES = 6;    TOTAL OUTFILES  = 8;
    IN SECTORS = 144;      OUT SECTORS = 13090;
 
 OUTFENCE = 6
 OUTFENCE = 10 FOR LDEV 6

This display consists of three parts. The values in the first two parts represent only those spool files selected for display.

SPOOLER, SPOOLF, SHOWIN, SHOWOUT, LISTFILE

Native Mode Spooler Reference Manual

Specifies the set of users to be listed. The default is all (@) users (and accounts) within the user's capabilities (AM or SM). Use wildcard characters to specify more than one user. Use the ? symbol to specify a single alphanumeric character. Use the # symbol to specify a single numeric character. Use the @ symbol to specify zero or more alphanumeric characters.

The name of the output file. The default is $STDLIST, a temporary file that cannot be overwritten by a BUILD command. It is automatically specified as a new ASCII file with variable-length records, closed in the temporary domain, user-supplied carriage-control characters (CCTL), OUT access mode, and EXC (EXCLUSIVE access) option. All other characteristics are the same as they would be with the FILE command default specifications.

Permits users with account manager (AM) and system manager (SM) capability to see the user password.

Used to specify one of several display formats.

ALTUSER, LISTACCT, LISTGROUP, NEWUSER, PURGEUSER, PXUTIL

None

Specifies the home volume set for the group and account specified, or for the logon group and account if groupname or groupname.acctname is not specified.

An artificial component of a volume set name used to maintain backward compatibility with MPE V/E.

Used only for compatibility with MPE V/E.

Used only for compatibility with MPE V/E.

A value from -1 to 32,767 specifying which generation of the home volume set is to be reserved. A value of -1 indicates that any generation is permitted. If omitted, the system ignores the generation when attempting to satisfy the MOUNT request.

MOUNT, DISMOUNT, DSTAT, VSRESERVE, VSRELEASE

Volume Management Reference Manual

Logging identifier previously established with a user GETLOG command.

Initiates a logging process.

Restarts a logging process.

Terminates a logging process.

ALTLOG, CHANGELOG, GETLOG, SHOWLOGSTATUS

User Logging Programmer's Guide

The number of the session or the job that is to remain logged on after all others are aborted. Default is that all sessions and all jobs are logged off.

=LOGON, ABORTJOB, TELL, WARN

System Startup, Configuration, and Shutdown Reference Manual

Performing System Operation Tasks

=LOGOFF

System Startup, Configuration, and Shutdown Reference Manual

Performing System Operation Tasks