HP MPE/iX 6.x Operating System 135

LISTFILE

Operation Notes

You can use LISTFILE to list descriptions of one or more disk les at the level of detail you select. You must have traverse directory (TD) en tries and/or read directory (RD) en tries for the directories in the pathname of the les that will be displa yed by LISTFILE . (Refer to the ALTSEC command for further information on directory permissions.) F or example, if the leset is

./dir1/dir@/@ and NAME=@ , you must have TD access for the CWD. Also, y ou must have TD and/or RD access for dir1 and any directories in dir1 that match the pattern dir@. You do not need TD access on the directories in dir1 to display the names of the les, that is, if y ou use format options 0 or 6.

For format options -1, -2, -3, and -5, y ou must have either SM or AM capability for the le. A le description is not listed unless the le's home volume set (PV) is moun ted.

Use

This command ma y be issued from a session, a job, a program, or in break mode. Pressing 4Break5 aborts execution.

If the leset is in MPE syntax, LISTFILE does not displa y le names that do not follow MPE naming syn tax. For example, LISTFILE @,2 will not displa y the le am_pm, LISTFILE ./@,2 will display the le.

If the leset is in HFS syntax, and it ends in a slash (or the TREE option is specied), rst all the nodes (les and directories) are displa yed that match the leset parameter (horizon tal cut). Those les that matc h the pattern of pattern are the ones that are displa yed using the format opt specied.

If the HFS syntax leset does not end in a slash (or the NOTREE option is specied), all the nodes (les and directories) that matc h the pattern of leset (horizontal cut) and the pattern of pattern are displayed using the format opt specied.

In both the above cases, a nal lter of SELEQ is applied, if presen t, to further restrict the names to be displa yed.

MPE/iX Commands 2-123

Contents

HP 3000 Series 9X8LX Computer Systems Commands Reference Hewlett-PackardCompany 3000 Hanover Street Palo Alto, CA 94304 U.S.A Printing History In This Book Related Manuals Note 4.5 and 5.0 to include additional features that include POSIX le system is tree structured and can con tain les at man y called a directory. Instead of holding data, directories con tain lists of les and poin ters to those les Contents Page Page Figures Tables Introduction to Command Parameters Parameters within Syntax Page MPE/iX Commands ABORTJOB/4Ctrl5A ABORTJOB Operation Notes You need to use the SHOWJOB command to determine the job or session number of the operation y ou want to cancel. If y ou command later in this c hapter s co Page Related Commands ALLOW You can only allow commands to users curren tly logged on unless y ou use the parameter, then use the The ALLOW command enables y ou to enter the command in one of three modes: interactive subsystem Page Execute the You can also include a loc kword for the le, if an y, as shown: You can backreference the le with a le equation, as sho wn: ALTACCT 8 ACANY 9 8 L < AL of users (ANY, AC, GU, AL, GL) and are dened as follo ws: Page Page Page ALTFILE Page Page ALTGROUP The default is IA and BA, except for the PUB group of the SYS account. The default for PUB.SYS is PH, DS, MR, PM, IA and BA. Typically, you should not change PUB.SYS because it is delivered. You must separate each capability class with a Page To assign a new passw ord, PASS2, to a group named GROUPX , enter: ALTSEC 9 (acdpair ;acdpair Page leaccess File access mask specications, en tered as follows: 8 LR 8 AC < W > A > AL users (ANY, AC, GU, AL, GL, CR) as follo ws: Page The userspec part consists of a fully qualied user name ( username.accountname) the le owner represented as $OWNER the le group represen ted as $GROUP the le group mask represen ted as $GROUP_MASK Page You use the , and . A le's access mask ma y be altered using either the keyword or an access specication without a k eyword. Using the File Access Matrix Examples Page Page leaccess ALTUSER The default is IA, BA, ND, and SF Note the following points about this parameter: Capabilities assigned to the user cannot exceed those assigned to the accoun t Any capabilities remo ved from the accoun t cannot be Basic guidelines for altering user parameters are as follo ws: To change the password and capabilit y list of JONES, enter: BREAKJOB To suspend the processing of job n umber 68, enter: To display suspended jobs, en ter: BYE Page CHDIR The table below summarizes the dierences and similarities bet ween the and commands Use Page Page CHGROUP Page COMMENT Page CONSOLE Page CONTINUE COPY Valid replies to this prompt are: and create a new targetle Instructs COPY to terminate ASK is the default, except in a job or in other cases when the meaning, and YES becomes the default Page Page DISCUSE (UDC) Page DISKUSE There are several ways to see all disk space used on the system: Page Page Page Page Page Page Page EDITOR Page Page EOJ Page FCOPY Copy data from any input device to an y output device Create multiple copies of les Copy portions of a le Page FILE Page Species a parameter with one or more of three parameter options: device, outpri, or numcopies . If you use DEV, you which species the default device class of DISC You can use a previously dened en vironment identier for the DEV parameter, but y ou cannot use the domain and blockfactor Species the number of logical records per Denes the format of the records of the le A le can contain xed-lengthrecords ( F) records (V). The default is F for disk les Page Page HELLO Page Page Page Page HELP Page Page The system responds b y displaying: Page Type ABORT at the prompt located at the bottom of the screen, as sho wn: To display a summary of the Help F acility subsystem, en ter: The system responds b y displaying the follo wing screen: To review commands listed b y the functional tasks they perform, en ter: To display the contents of a le named TEST, enter: The system responds b y displaying the follo wing: JOB Page Page Page cann To properly use this command, y ou must adhere to the following requirements: Terminate the JOB command with an EOJ command job number, as assigned b y the system to iden tify the job date and time To create a job le and submit it for processing, do the follo wing: 1.Enter the follo wing command to invoke the EDIT subsystem: 2.Enter the ADD command, then add job le commands, as sho wn: 4.Submit the job le for processing b y using the STREAM command: Page JOBFENCE 1. Set the jobfence to 14: 2.Enter the SHOWJOB command to displa y the eect of the new jobfence: 3.Reset the jobfence to 6 to allow w aiting jobs to log on: Page LIMIT You cannot log on as a non appears To limit the number of jobs to 2 and the n umber of sessions to 15, en ter: The system responds as follows when y ou enter the SHOWJOB command: LISTACCT Page Page LISTFILE Page Page If leset does not end in a slash, all of the les that matc h For example behaves like: Page The following table displa ys the format options a vailable Page or you may select object types by using the OBJECT option. Selection equations ha ve the following format: Selection equations m ust be surrounded by square brackets For example: In the above example, the lename represen ts Lists only the MPE Page Page Page Page HPPROMPT variable has been set to sho w the current working directory , changes directories using the CHDIR command, and requests NAME parameter to request a listing The next example illustrates the use of the OBJECT=ACCT parameter to sho w all accounts on the system OBJECT=DIR parameter to sho w all directories on the system Page Page Page FORMAT=-3 option to show the owner. You must be the owner, or have AM or SM capabilit y to use this option FORMAT=4 (SECURITY) option to Page Page LISTGROUP To display information, including the passw ord, for a group named , enter: The system responds b y printing the following information on y our screen: LISTSPF Page Page Page Page ACTIVE OPEN Indicates the number of JOB input spool les (the the job's CI process, or the n umber of data input spool les that are being accessed b y a process Page The system responds b y producing the following displa y: Page The system responds b y producing the following status displa y: LISTUSER To display information, including the passw ord, for a user named PETE, enter: To display all users in an accoun t named PRACTICE , enter: NEWACCT The defaults are AM, AL, GL, SF, ND, IA, and BA Page Page Page NEWDIR specifying the full pathname of the directory DIR1 in the dir1 in the current working directory (CWD). Note that in this example, the dir name is not shifted to uppercase The next example creates an MPE-nameddirectory called A in the group B NEWGROUP > GL where R, L, A, W, and X specify modes of access b y types of users (ANY, AC, GU, AL, and GL) and are dened as follo ws: Page Page NEWLINK Page Page Page Page Page The following examples demonstrate the beha vior of this command Page NEWUSER user Page OUTFENCE 1. Set the global outfence to 14 and the outfence of LDEV 6 to 7, as sho wn: This device-specicoutfence tak es precedence over the global outfence The system responds as sho wn: 3.Reset the outfence for all output spool les, as sho wn: To dene an outfence of 5 for device class PP80, en ter: Page PASSWORD PRINT 2 ;8 unn/num 9 New les are created as TEMP To send the contents of MYFILE to the line printer, XXX, enter: Since the default is temporary , the SAVE command permanently saves the le PURGE To delete a permanen t le named PFILE, enter: To purge multiple les using wildcards To purge multiple les interactively using wildcards Page PURGEACCT Page PURGEDIR directory. A dierent prompt is seen depending on whether name is to be purged with the TREE option or with the trailing slash feature. CONFIRM is the default for sessions CONFIRM is ignored for jobs name (and all objects under it for Page Valid responses are ALL, NO, and N (case insensitive) If dir name is long, the prompt ma y wrap around. If dir is an MPE name, it is fully qualied in the prompt message If the YES option is selected, then the purge is automatically The following examples purge dir1 and all objects belo w dir1 The next example sho ws the command to purge MYDIR The next example sho ws the command to purge MYDIR and all objects belo w The next example illustrates the SHOW and TREE options Page The following examples sho w how to use wildcards with PURGEDIR This example deletes all directories rooted to /MYACCT/MYGRP PURGEGROUP To purge a group named EXCESS , enter: PURGELINK Page PURGEUSER Anyone can enter the PURGE command for eac h le to be deleted To remove a user named USER1 , enter: RECALL/4Ctrl5A RECALL To display all pending console messages from y our terminal, enter: If no requests are pending for a reply , the following message appears: To display all pending console messages from the console, en ter: :4Ctrl54A5 RELEASE For more information about A CDs, refer to the ALTSEC command in this manual This command does not aect the following access con trols: Privileged les You cannot release privileged les Lockwords RENAME To change the name of a le named OLDFILE to a le named NEWFILE , enter: To change the lockword of the le FILE2 from LOCKA to LOCKB , enter: To move a le from GROUP1 to GROUP2 within the same accoun t, enter: REPLY/4Ctrl5A REPLY ole To respond to the follo wing standard tape message, en ter: 4CTRL5 4A5 To reply to a standard forms request, en ter: Page REPORT You can use the follo wing wildcard c haracters to specify a set of names: Species one numeric character Species one alphanumeric character You can use these characters as follo ws: \n Page Page RESTORE Page Page species one numeric character species one alphan umeric character These wildcard characters can be used as follows Restore all les starting with the c haracter n Restore all les ending with the c haracter n All les that begin with the name end in E, F, or G, or end in D or E, or 1, 2, 3, 4, 5, or le.group.acct one particular accoun t @.group/log All the les (MPE and HFS) in one particular onacct/group group in the logon accoun t ?@.group Page Page Page Page No message is displa yed if AUTOREPLY is congured through SYSGEN Page Page To have the list of restored les prin ted on a line prin ter, enter To restore only a subset of the leset, en ter (Restores all les except those in the PUB group of the SYS account.) RESUME Page RESUMEJOB Page RUN Page The choices for this parameter are as follo ws: Indicates the formal le designator for a le previously specied in a le equation temporary disk le Indicates the actual le designator of a you can use quotes (" or ') with the program le name and/or the tain To use the INFO= parameter to pass a string to the program, en ter: SECURE Page SETCLOCK Providing a time zone spec is the only w ay to change the system time and main tain both local and Univ ersal Time (GMT) accurately. See the Operation Notes section for details This option is meaningful only when the date and time to speed up or slo w down until the time change is completed Correction: If the Correction form of the command is used, the system Page Page mma Examples of Date-Timeand Correction Forms: Page Page SHOWCLOCK SHOWDEV Page Page Species the tape densit y and can include one of the The density is bytes-per-inch(BPI) BPI, or the densit y of the tape is unrecognizable SHOWJOB 2 8 EXEC ,D 4 Page If you enter SHOWJOB STATUS , the following format appears: If you enter SHOWJOB SCHED , the following format appears: To display all jobs and sessions in the system, en ter: The output appears as sho wn: Page SHOWME To display the status of the curren t job or session, en ter: In the example abo ve, the elds show the following information: programmatically or directly from the MPE/iX command interpreter Shows two version, update lev el, and x (v.uu. ) Page SHOWTIME SPOOLER ;SHUTQ 2 ;SHOW the default for the START option users from generating spool les on the device(s). This parameter is the default for the STOP option For information about this parameter, refer to SHOW for the appearing as though the STOP parameter has not aected printing. This happens because the spooler stops sending data to the device when the command is receiv ed, but must wait until all buered data has been prin ted before stopping Depending on both the con tent of the data and the amoun t of Page Page ob To show the status of device name LP, enter: The asterisk beside LDEV14 indicates that the SUSPEND state is pending Page SPOOLF Page Page Page Page Page Page STORE An option specied on one line will operate on all les in the lesetlist has the form: lestostore[-lestoexclude[-lestoexclude[-...]]] be excluded from the STORE operation. You may specify an Since \-"is a valid character for HFS syn tax le names, a These wildcard characters can be used as follo ws Store all les starting with the c haracter n Store all les ending with the c haracter n by up to seven digits (useful for storing all EDIT/3000 temporary les) Page Page entered before the STORE command would send the listing to a line printer qualied path name, v olume restrictions, le and ending media n umber Page Page Page If you have purchased a Turbostore product, it will be installed as . As long as a non-zero length program exists in To store all les on the system (including HFS les), en ter To store all MPE named les (and exclude HFS les and directories), en ter To store all les on the system except the MPE les in the SYS account, enter To store from indirect le INDFILE which contains enter: Page STREAM day-of-month is greater than or equal to the current day-of-month the current month is the default. If is less than the current the the current date is used Page 1.Enter the following command to invoke the EDIT subsystem: Absolute with or without the DAY or DATE parameter Relative You specify a time oset from the curren t time using the IN Page To introduce JOBFILE immediately, enter: To introduce at 8:00 pm, Monda y, June 10, enter: in eight hours, at 8:00 pm, Monda y, June 10, enter: Page Page STREAMS Page SYSGEN Page To congure a tape driv e for autoreply mode, en ter: TELL nnn username.acctname Page TELLOP Page WARN Page WELCOME To create a multiline welcome message in teractively, enter: To use a predened message le called MESSAGE1 , enter: To delete MESSAGE1 , enter: XEQ Page Index