HP e3000 Command Reference Manual Download Page 93

Page: 93 / 334

FILE

Examples

run

the

program

MYPROG

that

do es

the

following:

references

les

the

names

( formaldesignators

)

SOURCE

and

DEST

uses

existing

disk

les,

INX

and

OUTX ,

the

actual

les

for

the

program

ter:

: FILE

SOURCE=INX

: FILE

DEST=OUTX

: RUN

MYPROG

send

output

new

le,

FILEX ,

that

has

64-word

xed-length

records

and

records

p er

blo

ASCI I

co de,

ter:

: FILE

DEST=FILEX,NEW;REC=64,2,F,ASCII

: RUN

MYPROG

Note

that

the

equation

only

dies

the

sp ecied

items.

Commands

BUILD

LISTEQ

RESET

MPE/iX

Commands

2-81

Summary of Contents for e3000

Page 1: ...HP 3000 Series 9X8LX Computer Systems Commands Reference ABCDE HP Part No B3813 90011 Printed in USA 1994 First Edition E0494 ...

Page 2: ...ftware on equipment that is not furnished by Hewlett Packard This document contains proprietary information which is protected by copyright All rights are reserved Reproduction adaptation or translation without prior written permission is prohibited except as allowed under the copyright laws Copyright c 1994 by Hewlett Packard Company Use duplication or disclosure by the U S Government is subject ...

Page 3: ...on The software version indicates the version of the software product at the time this document was issued Many product releases do not require changes to the document Therefore do not expect a one to one correspondence between product releases and document editions Edition Date Software Version First Edition April 1994 B 50 00 iii ...

Page 4: ...anuals that includes the following Understanding Your System B3813 90001 If you are new to computers this is a good place to start It provides an introduction to what computers do and how they do it Getting Started B3813 90003 Familiarizes you with your computer and computer peripherals It also explains how to get your system ready for use how to use and maintain your tape drives and how to commun...

Page 5: ...hical le system is tree structured and can contain les at many di erent levels This organization provides a special kind of le called a directory Instead of holding data directories contain lists of les and pointers to those les For more information on POSIX and the hierarchical le system refer to the book New Features of MPE iX Using the Hierarchical File System 32650 90351 included in this docum...

Page 6: ...arameters 1 3 2 MPE iX Commands ABORTJOB 4Ctrl5A ABORTJOB 2 2 ALLOW 2 6 ALTACCT 2 11 ALTFILE 2 16 ALTGROUP 2 19 ALTSEC 2 23 ALTUSER 2 34 BREAKJOB 2 38 BYE 2 40 CHDIR 2 42 CHGROUP 2 46 COMMENT 2 48 CONSOLE 2 50 CONTINUE 2 52 COPY 2 53 DISCUSE UDC 2 57 DISKUSE 2 59 EDITOR 2 68 EOJ 2 71 FCOPY 2 73 FILE 2 76 HELLO 2 82 HELP 2 87 Contents 1 ...

Page 7: ...ENCE 2 173 PASSWORD 2 177 PRINT 2 178 PURGE 2 181 PURGEACCT 2 184 PURGEDIR 2 186 PURGEGROUP 2 194 PURGELINK 2 196 PURGEUSER 2 198 RECALL 4Ctrl5A RECALL 2 200 RELEASE 2 202 RENAME 2 204 REPLY 4Ctrl5A REPLY 2 206 REPORT 2 209 RESTORE 2 213 RESUME 2 227 RESUMEJOB 2 229 RUN 2 231 SECURE 2 236 SETCLOCK 2 238 SHOWCLOCK 2 246 SHOWDEV 2 247 SHOWJOB 2 251 SHOWME 2 258 SHOWTIME 2 261 Contents 2 ...

Page 8: ...SPOOLER 2 262 SPOOLF 2 270 STORE 2 277 STREAM 2 289 STREAMS 2 297 SYSGEN 2 299 TELL 2 302 TELLOP 2 305 WARN 2 307 WELCOME 2 309 XEQ 2 311 Index Contents 3 ...

Page 9: ...Figures 2 1 Hierarchical Directory Structure 2 62 2 2 DISKUSE Output Format 2 63 2 3 Example File System 2 125 Tables 2 1 Primary EDIT 3000 Commands 2 69 2 2 Format Options 2 119 Contents 4 ...

Page 10: ...Provides the command name at the top of each page followed by a brief de nition Syntax Provides a diagram that shows how to enter the command and its parameters Parameters Explains each parameter including its function limitations and defaults Operation Notes Explains how to use the command and may also include advisory information such as requirements restrictions and operating processes Examples...

Page 11: ... example my le is a required parameter because no marks surround it BUILD my le Anything italicized such as my le is a representational name or value and must be replaced with an actual name or value Sometimes you must select one parameter from two or more parameters In the following example you must provide either a job number or a session number because braces surround these parameters ALTJOB Jn...

Page 12: ...e optional parameter PASS Positional parameters The e ect of a positional parameter depends on its location in the parameter list In the syntax diagram for each command the comma separates positional parameters If you omit a positional parameter from the list you must provide a comma placeholder that would normally precede that parameter In the following example the parameter values that follow th...

Page 13: ... Each command is presented in alphabetical order To get help on any parameter not found in this chapter use the MPE iX online help facility described in the Task Reference B3813 90009 To get help on a command not in this book type help and the command name next to the MPE iX prompt For example to get help on LISTFILE type HELP LISTFILE MPE iX Commands 2 1 ...

Page 14: ...terminate one or more sessions if necessary for system emergencies or scheduled shutdowns Syntax From a terminal ABORTJOB 8 Jnnn Snnn 2 jobname 3 user acct 9 From the console 4Ctrl5A ABORTJOB 8 Jnnn Snnn 2 jobname 3 user acct 9 Parameters Jnnn Speci es a job number Snnn Speci es a session number jobname Speci es the name of the job as identi ed by the SHOWJOB command user Speci es a user name acct...

Page 15: ...e The sign appears when you press 4Ctrl54A5 Pressing these keys enables you to enter certain commands on a console from which another process such as STORE is currently running Recommended usage If you use the jobname user acct form of the command when more than one job or session is executing with the same name the system selects the job or session that it aborts Consequently you should use the J...

Page 16: ...er 9 enter ABORTJOB J9 The system responds by displaying the following logo message if the executing job successfully terminates 20 18 J9 26 LOGOFF ON LDEV 10 This message does not appear when you terminate waiting or scheduled jobs To terminate session 6 which has the following pending device allocation message enter 17 00 S6 23 LDEV FOR SCRTAPE ON TAPE NUM ABORTJOB S6 The system responds by disp...

Page 17: ...ABORTJOB 4Ctrl5A ABORTJOB Related Commands ALLOW BREAKJOB CONSOLE JOBSECURITY SHOWJOB STREAM MPE iX Commands 2 5 ...

Page 18: ...ss to all users whether or not they are logged on acct Gives access to all users logged on to a speci c account user Gives access to a speci c user logged on to any account user acct Gives access to a speci c user logged on in a speci c account COMMANDS Speci es the names of the console commands that the user s can access FILE Speci es an ASCII le name formaldesignator that consists of from one to...

Page 19: ...ers Additional commands that you allow for users are valid only for the duration of their current session When a user logs o and then back on to the system the previously allowed commands are no longer available until they are allowed again Command modes The ALLOW command enables you to enter the command in one of three modes interactive subsystem program When using interactive mode you enter the ...

Page 20: ...be preceded by 4Ctrl54A5 Some console commands have the same name as non console commands such as RECALL which can be entered on any device Operator commands are generally used in the daily operation of your system and are generally allowable Allowable commands You can allow up to 19 of the following commands at a time in interactive and subsystem modes If you need to specify more than 19 commands...

Page 21: ...ing command at the console ALLOW USER TECH COMMANDS REPLY ABORTJOB In subsystem mode to allow a user named MGR MANUALS to enter the BREAKJOB command enter the following command sequence at the console ALLOW MGR MANUALS COMMANDS BREAKJOB EXIT In program mode to allow the users named SUSAN PAYROLL and JOHN ACCTNG to enter the LIMIT command do the following 1 Execute the EDITOR command create a progr...

Page 22: ...t executes from the le ALLOW FILE ALLOWTMP SHOW You can also include a lockword for the le if any as shown ALLOW FILE ALLOWTMP LOCKWORD SHOW You can backreference the le with a le equation as shown FILE BACKF ALLOWTMP ALLOW FILE BACKF SHOW Related Commands CONSOLE DISALLOW SHOWALLOW 2 10 MPE iX Commands ...

Page 23: ...ing the ALTACCT command without this parameter retains the current password Entering PASS without specifying password removes the existing password Entering PASS and specifying password changes the current password or creates one if a password did not previously exist CAP Speci es the list of capabilities permitted for this account that were assigned with the NEWACCT command Each capability is ind...

Page 24: ...s assigned the maximum account capabilities when the system is delivered If you remove a capability from an account it is unavailable to users of that account only after they log o the system and then log back on ACCESS Speci es the restriction on le access pertinent to this account Valid syntax options are as follows 2 6 6 6 6 6 6 6 4 8 R L A W X S 9 2 3 8 ANY AC GU AL GL 9 3 7 7 7 7 7 7 7 5 2 3 ...

Page 25: ... Pressing 4Break5 does not a ect this command You must have system manager SM capability in order to use this command Altering account parameters Basic guidelines for altering account parameters are as follows You can enter multiple parameters on a single command line by using the semicolon delimiter When you change one capability in a capability list that contains several nondefault values you mu...

Page 26: ...ithin the account are denied the capability Restrictions You cannot remove system manager SM capability from the SYS account or account manager AM capability from any account From within any account you can remove AM capability from all but one the last of the users assigned the capability however you can remove AM capability from all users in an account if you do this from another user and accoun...

Page 27: ...ALTACCT Related Commands ALTGROUP ALTUSER LISTACCT LISTGROUP LISTUSER NEWACCT NEWGROUP NEWUSER REPORT RESETACCT MPE iX Commands 2 15 ...

Page 28: ...sing both MPE and HFS syntaxes MPE syntax names may not include lockwords the lockword for a lockworded le is not needed for this command to succeed and if included in the lename results in an error ownername The name of the user who will become the owner UID of lename This ownername must already exist on the system Default is for the UID of the le to remain unchanged Note that no quali cation is ...

Page 29: ...bility In this case ownername may specify any user existing in the user database To change the GID of a le you must be one of the following The le owner a user whose logon name matches the UID of the le In this case POSIXgroupname must specify the user s logon account The le s account manager whose logon account matches the GID of the le and who has the MPE iX account manager AM user capability In...

Page 30: ...ALTFILE Related Commands ALTSEC 2 18 MPE iX Commands ...

Page 31: ... manager SM capability to use this parameter PASS Speci es the group password Entering the ALTGROUP command without this parameter retains the current password Entering PASS without specifying password removes the existing password Entering PASS and specifying password changes the current password or creates one if a password did not previously exist CAP Speci es capability class attributes consis...

Page 32: ... as follows 2 6 6 6 6 6 6 6 4 8 R L A W X S 9 2 3 8 ANY AC GU AL GL 9 3 7 7 7 7 7 7 7 5 2 3 where R L A W X and S specify modes of access by types of users ANY AC GU AL GL and are de ned as follows R Read L Lock exclusive file access A Append implies L W Write implies A and L X Execute S Save The user types are de ned as follows ANY Any user AC Member of this account only GU Member of this group o...

Page 33: ...le parameters on a single command line by using the semicolon delimiter When you omit an entire parameter the corresponding value for the group remains unchanged When you include a parameter but omit its value as in PASS 4Return5 the default value is assigned Activating the changes If you alter one or more parameters the changes in the directory become e ective immediately however the changes do n...

Page 34: ...enter ALTGROUP GROUPX PASS PASS2 To assign the same password to the same group as above and add DS and PH capabilities enter ALTGROUP GROUPX PASS PASS2 CAP IA BA DS PH Related Commands ALTACCT ALTUSER LISTACCT LISTGROUP LISTUSER NEWACCT NEWGROUP NEWUSER 2 22 MPE iX Commands ...

Page 35: ...archical directories and to les existing in hierarchical directories You can change access permissions for any of the following les hierarchical directories devices device classes You can also change le access masks with this command only les have access masks The le status change time stamp is updated by ALTSEC Note The ALTSEC command cannot be used to change access permissions for MPE groups acc...

Page 36: ...ou want to alter Either MPE or hierarchical le system HFS le name syntax may be used for the actual le designator of the le or directory whose access permissions are to be altered You can only use wildcard characters with MPE syntax les that reside in a group A logical device number must be a numeric value con gured on the system or an sign that indicates all devices on the system A device class n...

Page 37: ...using HFS le name syntax with either a dot or a slash character The maximum length is 255 characters including the or The objectname parameter is followed by one of the three type identi ers listed below FILENAME A type identi er that indicates objectname refers to either a le or directory The FILENAME type identi er is the default if a type identi er is not speci ed LDEV A type identi er that ind...

Page 38: ...e user types are speci ed as follows ANY Any user AC Member of this account only GU Member of this group only AL Account librarian user only GL Group librarian user only CR Creator You may specify two or more user types if you separate them by commas The default is R L W A X ANY The colon separating one or more modes from one or more user types is required punctuation in the speci cation of leacce...

Page 39: ... existing ACD pair if it has the same user and account name acdpair An access control de nition pair Like the leaccess parameter this consists of a modes part and a userspec part The modes part is separated from the userspec part by a colon Acceptable modes for les are R read file access W write file access L lock file access A append file access X execute file access NONE no access RACD copy or r...

Page 40: ...ite access to any user of the MRKT account along with the ability to read or copy the ACD and Read access to any user in any account lereference A le containing one or more ACD pairs ACD pairs must be separated by semi colons and may be placed on separate lines A single ACD pair may not span more than one line The le name must be preceded by the sign caret symbol to indicate that the designated le...

Page 41: ...e speci ed for the accountname unless it is also speci ed for the username COPYACD Indicates copy ACD Use COPYACD to copy an ACD from an existing objectname to the speci ed objectname ACDs can be copied only between like objects You must specify FILENAME or LDEV FILENAME is the default You cannot copy an ACD from a device class DEVCLASS although you may copy to all devices on the system by specify...

Page 42: ...rchical directories have their owner s identity and a le group ID GID stored in their le labels System managers have the appropriate privilege to manipulate the ACDs for all objects Account managers for the account matching an object s GID have appropriate privilege Devices are owned by system managers The ability to manipulate an ACD or le mask is not a ected by the object access currently grante...

Page 43: ...g write access to a user named FRIEND ACCT Enter ALTSEC FDATA NEWACD W FRIEND ACCT As the creator of a le you can access the le by default so you don t need to grant yourself access through an ACD Users with appropriate privileges are always permitted to access les protected by ACDs To extend the ACD for the FDATA le so that all users on the system can read it and all users within your account ACC...

Page 44: ...ACD which already exists for le PROGNAME which will allow the user ENGR of the LAB account to read write lock append execute and read the ACD information enter ALTSEC PROGNAME ADDPAIR R W X RACD ENGR LAB Note that L and A lock and append need not be speci ed because they are implied with W write To add an ACD that prevents any user except OPERATOR SYS and any user with SM capability from accessing...

Page 45: ...ALTSEC Related Commands LISTF LISTFILE RELEASE SECURE SHOWDEV and the leaccess parameter for ALTACCT ALTGROUP NEWACCT NEWGROUP MPE iX Commands 2 33 ...

Page 46: ...ility to use this parameter from outside the account or you must have account manager AM capability to use this parameter from within the account PASS Speci es the user password used for verifying logon access only The password must consist of one to eight alphanumeric characters beginning with an alphabetic character The default is that no password is assigned If you omit the parameter PASS the e...

Page 47: ...abilities assigned to the user cannot exceed those assigned to the account Any capabilities removed from the account cannot be assigned to the user The user s capabilities are always veri ed to be a subset of the account s capabilities at logon This prevents a user from having a capability not assigned to the account HOME Speci es the name of an existing group to be assigned as the user s home gro...

Page 48: ...ity you can remove the capability from all but one user When you omit an entire parameter the corresponding value for the group remains unchanged When you include a parameter but omit its value as in PASS 4Return5 the default value is assigned You cannot remove SM capability from MANAGER SYS You cannot remove your own AM capability Activating the changes If you alter one or more parameters the cha...

Page 49: ...o include privileged mode PM capability enter ALTUSER JONES CAP IA BA SF PH DS PM To change the password and capability list of JONES enter ALTUSER JONES PASS JJ CAP IA BA SF PH DS PM Related Commands ALTACCT ALTGROUP LISTACCT LISTGROUP LISTUSER NEWACCT NEWGROUP NEWUSER MPE iX Commands 2 37 ...

Page 50: ...m a terminal other than the console under one of the following conditions The JOBSECURITY command is set to LOW and the job is logged on to your user account AM users only need to match the job s account name Your system administrator has used the ALLOW command which permits you to enter this command Nonshareable devices When you enter this command for a job that controls a nonshareable device a c...

Page 51: ...r 68 enter BREAKJOB J68 To display suspended jobs enter SHOWJOB SUSP JOBNUM STATE INPRI JIN JLIST INTRODUCED JOB NAME 68 SUSP 105 LP WED 7 56AM TEST USER ACCT Related Commands ALTJOB ABORTJOB CONSOLE JOBSECURITY RESUMEJOB SHOWJOB STREAM MPE iX Commands 2 39 ...

Page 52: ...does not a ect this command Automatic termination The system automatically terminates your session under the following circumstances If you enter the HELLO command without logging o your current session MPE terminates your current session and immediately initiates a new one If you are logged on over a telephone line and you hang up before terminating your session the system automatically issues th...

Page 53: ...BYE The termination message shown above does not appear if you entered the BYE command before you initiated a session on the system Related Commands EOJ EXIT HELLO MPE iX Commands 2 41 ...

Page 54: ...rectory changed to SHOW is the default NOSHOW Does not display the absolute pathname Operation Notes You can use the CHDIR command to change the process CWD to dir name If dir name is omitted the logon group is assumed The user always has a logon group The CHDIR command changes the CWD to an MPE named directory This means that dir name must follow all MPE naming rules unless it is pre xed with a d...

Page 55: ...oo long or has been removed for example with the 2 shell rmdir command then HPCWD will not be accessible The CHGROUP command causes the HPCWD variable to be set to account group changed to The table below summarizes the di erences and similarities between the CHDIR and CHGROUP commands A ects CHGROUP CHDIR Accumulation of CPU and Connect time yes no Set of accessible les yes no CWD of process yes ...

Page 56: ...he MYACCT account d a c b CHDIR MYACCT AGROUP The following example shows the command entry to change to a directory named My_dir In this example My_dir is a relative pathname that is relative to the current working directory CWD d a c b CHDIR My_dir The following example shows the command entry to change to a directory named john in the group JONES in the account MYACCT by specifying the full pat...

Page 57: ...inal by specifying the relative pathname The variable HPCWD displays the current working directory after the change is made d a c b CHDIR es final SHOWVAR HPCWD HPCWD MYACCT JONES john es final Related Commands CHGROUP FINDDIR UDC LISTDIR UDC NEWDIR PURGEDIR MPE iX Commands 2 45 ...

Page 58: ... provide a password Operation Notes Usage You can enter this command from a session or a job but not from a program or in break mode Pressing 4Break5 does not a ect this command Command interpreter preservation This command preserves the entire command interpreter environment temporary les le equations and variables Password requirements In a batch job you must supply a password if a password is a...

Page 59: ...roup enter CHGROUP To switch from the current group to the group called GROUP2 enter CHGROUP GROUP2 To switch from the current group to the group called GROUP2 with the assigned password SECRET enter CHGROUP GROUP2 SECRET Related Commands HELLO MPE iX Commands 2 47 ...

Page 60: ... only the string COMMENT is inserted in the command stream Operation Notes Usage You can enter this command from a session a job a program or in break mode Pressing 4Break5 does not a ect this command Adding comment lines To continue comment text onto the next line use an ampersand as the last nonblank character of the line Add the ampersand for each line of text that you want to continue Example ...

Page 61: ...COMMENT Related Commands None MPE iX Commands 2 49 ...

Page 62: ...ermine the location of the console however you must enter this command from the console to change its location unless your system administrator has used the ALLOW command which permits you to enter this command Command process When you enter this command a message that shows the new logical device number appears on the new console as well as the former console All console capabilities transfer to ...

Page 63: ...ts and messages remain with the con gured terminal such as channel 1 device 0 for example You cannot move this feature to another terminal You can only execute console 4Ctrl5A commands from the console Examples To determine the current location of the console enter CONSOLE CONSOLE IS CURRENTLY ASSIGNED TO LDEV 20 To transfer the console from the terminal identi ed by the system as logical device 2...

Page 64: ...n and the system displays an accompanying error message Syntax CONTINUE Parameters None Operation Notes Usage You can enter this command from a job but not from a session a program or in break mode Pressing 4Break5 does not a ect this command Example To override a possible error resulting from the processing of MYPROG and enable JOB1 to continue executing insert the following in your le JOB JOB1 U...

Page 65: ...rrent working directory CWD You may qualify target le with both le and group names or specify only the destination group If only group is speci ed COPY puts a copy of the source le in a le called source le in the speci ed group Since groupname can be speci ed as the target le and HFS le names can also start with a dot this could lead to confusion as to whether an MPE group or HFS le name is desire...

Page 66: ...leaves source le unchanged Both les must be nonspooled disk les residing on the host system You may specify les that are backreferenced with a le equation However this command only supports three le equation options the le name the nal disposition TEMP or SAVE and the disk volume or volume class DEV DISC or DEV DISC LDEV NUMBER All other le equation options are ignored The le disposition of target...

Page 67: ...sing the COPY command If source le or target le is actually a directory an error is returned CM les and temporary les cannot be copied to HFS directories Examples To copy ABCD logongroup to EFG logongroup enter COPY ABCD EFG To copy ABCD logongroup to ABCD newgroup enter COPY ABCD newgroup To copy ABCD grp to ABCD logongroup enter COPY ABCD grp In the next example the le MYFILE PUB SYS is copied t...

Page 68: ...ir1 d a c b COPY dir0 file1 dir1 file2 In the following example the le TEST has a lockword which is the word LOCK The le is copied into file1 in the dir0 directory d a c b COPY TEST LOCK dir0 file1 The following example copies the le a b file to the CWD as le For example if your CWD is ACCT GRP then the copied le will be named ACCT GRP file d a c b COPY a b file Related Commands FCOPY 2 56 MPE iX ...

Page 69: ...REE 3 Parameters Refer to the DISKUSE command for a complete explanation of the parameters used with the DISCUSE UDC The following parameters are supported with the DISCUSE UDC dir name Directory name for which information is being listed optional TREE Causes all directories below and including dir name to be reported NOTREE Causes dir name only to be reported USENAME Causes DISKUSE to use dir nam...

Page 70: ...llustrates the use of the DISCUSE UDC Note that a message is printed to remind you to use the DISKUSE command d a c b DISCUSE Please use the DISKUSE command SECTORS TREE LEVEL DIRECTORY CWD ACCT GROUP d0 BELOW 2100 330 Refer to the DISKUSE command later in this chapter for additional examples Related Commands DISKUSE LISTFILE REPORT 2 58 MPE iX Commands ...

Page 71: ...w and including dir name to be reported The dir name may or may not end in a slash with no error or warning detected Since the MPE naming convention does not support a trailing slash the TREE option is the only way to report multi level disk space usage for an MPE named directory in a single command NOTREE Causes dir name only to be reported If dir name is an HFS name and ends in a slash a warning...

Page 72: ...sions to each directory contributing to the reported totals TD access is needed to each directory component named in dir name Refer to the ALTSEC command in this chapter for additional information on directory permissions Note that the MPE syntax cannot specify a group account MPE syntax only permits dir group acct if dir is a valid MPE name that is all uppercase alphanumeric If group account were...

Page 73: ... display disk space used by all directories directly under the root enter DISKUSE Examples Figure 2 1 illustrates a hierarchical directory structure In this gure directory names are shown as the character d plus a number for example d0 and le names are shown as the character f plus a number for example f1 All of the examples following Figure 2 1 assume the directory structure shown For illustrativ...

Page 74: ...6 d7 f7 f8 f9 f10 f11 f12 d8 f13 f14 f15 d9 f16 f17 f18 f19 f20 Figure 2 1 Hierarchical Directory Structure The example shown in Figure 2 2 illustrates the format of the DISKUSE output In this example the TREE option is implied by the trailing slash 2 62 MPE iX Commands ...

Page 75: ...s with a dollar sign Each of the columns contains information about the directory DIRECTORY left justi ed Displays the selected directory name in HFS format The directory pathname wraps around to the next line if it is longer than the eld LEVEL BELOW right justi ed Shows the number of sectors allocated directly to all objects immediately under the named directory The space used by the listed direc...

Page 76: ...plus signs shown in the TREE column of Figure 2 2 refer to the directories that are one level below the target directory When added the sectors shown in this example equal 896 The last entry shows the total number of sectors 960 used by all subdirectories under the target directory 896 plus the sectors used by the target directory itself 64 The next example illustrates the use of the NOTREE option...

Page 77: ...d a c b ACCT GROUP d0 diskuse d3 tree SECTORS TREE LEVEL DIRECTORY CWD ACCT GROUP d0 BELOW 64 0 d3 d7 d9 208 144 d3 d7 208 d3 ACCT GROUP d0 You can use MPE syntax as shown in the following example note that the dir name MYDIR is upshifted This example is not based on the directory structure shown in Figure 2 1 d a c b DISKUSE mydir group acct SECTORS TREE LEVEL DIRECTORY BELOW 2100 330 ACCT GROUP ...

Page 78: ...pplied directory name upshifted in MPE format You can use wildcards to see a horizontal cut of disk space usage at an arbitrary directory depth Wildcarding can be used in TREE and NOTREE output as shown in the following examples d a c b ACCT GROUP d0 diskuse SECTORS TREE LEVEL DIRECTORY CWD ACCT GROUP d0 BELOW 64 0 d1 448 240 d2 336 128 d3 848 ACCT GROUP d0 Using Wildcards with NOTREE Output 2 66 ...

Page 79: ...y name and the total number of sectors under the TREE column The nal TREE number always equals the sum of all other TREE numbers for directories with the same number of components as contained in the user speci ed name that are designated with a plus sign in the TREE column For example if you speci ed a pathname with three components then the sum of the TREE eld for all directory names with exactl...

Page 80: ...sion or a job You cannot enter it from a program unless you or the program have process handling PH capability You also cannot enter this command from break mode Pressing 4Break5 suspends execution of this command entering the RESUME command continues execution Examples Table 2 1 lists the primary EDIT 3000 commands explains their purpose and provides an example of each command 2 68 MPE iX Command...

Page 81: ... FIND To locate a point in the work le FIND FIND PROGRAM HOLD To copy text from the work le into the hold le either replacing or appending HOLD 100 150 APPEND HOLD 1 10 INSERT To insert text into the work le from the terminal and the hold le INSERT 25 4 JOIN To add all or part of a le to the work le JOIN FILE02 TO 1000 by 1 KEEP To save all or part of the work le in a user le KEEP FILE02 LIST To d...

Page 82: ...ed Command Purpose Example TEXT To copy the contents of a user le into the work le to be edited TEXT FILE02 XPLAIN To get help on one or more commands XPLAIN ALL provides help on all commands XPLAIN TEXT Related Commands FCOPY PRINT 2 70 MPE iX Commands ...

Page 83: ...b but not from a session a program or in break mode Pressing 4Break5 does not a ect this command Omitting the command If you omit this command from an input le the next JOB command terminates the current job and starts a new one The standard end of job display indicates the end of the rst job and the normal job initiation display indicates the beginning of the next job Example To terminate an inpu...

Page 84: ...EOJ Related Commands EXIT JOB STREAM 2 72 MPE iX Commands ...

Page 85: ...e of the le target le to which source le is to be copied If you omit target le source le is copied to the STDLIST device NEW Creates a new permanent disk le The default is that target le must already exist Operation Notes Usage You can enter this command from a session a job or a program Pressing 4Break5 suspends the execution of this command Entering the RESUME command continues execution of the ...

Page 86: ...netic tape to disk for example Convert data from one computer code system EBCDIC for instance to another ASCII for instance as you copy the data Copy portions of a le Refer to the FCOPY Reference Manual 32212 90003 for information on using these capabilities Examples To copy the le TEST to a new le named TEMP from the MPE command interpreter enter FCOPY FROM TEST TO TEMP NEW HP32212A 03 30 FILE CO...

Page 87: ...OPY utility subsystem and then exit enter FCOPY HP32212A 03 30 FILE COPIER C HEWLETT PACKARD CO 1990 FROM TEST2 TO TEMP2 NEW EOF FOUND IN FROMFILE AFTER RECORD 23 23 RECORDS PROCESSED 0 ERRORS EXIT END OF SUBSYSTEM Related Commands COPY RENAME MPE iX Commands 2 75 ...

Page 88: ...CC 2 APPEND 3 32 FORMS formsmsg 3 2 FORMID formid 3 NOCCTL CCTL Parameters formal designator The formal le designator interpreted according to MPE escaped semantics formaldesignator can be either an MPE le i e one that uses MPE syntax or it can be a POSIX le name beginning with a dot or a slash For example you can use the escaped pathname SYS PUB FILE since it is equivalent to the MPE name FILE PU...

Page 89: ...ed semantics lereference can be either an MPE le i e one that uses MPE syntax or it can be a POSIX le name beginning with a dot or a slash For example you can use the escaped pathname SYS PUB FILE since it is equivalent to the MPE name FILE PUB SYS If the le designator follows MPE syntax it must use this format lename lockword groupname accountname envid The lename groupname and accountname identi...

Page 90: ...d for an output spool le which can range from 1 the lowest priority to 13 the highest priority numcopies Speci es the number of copies requested for an output spool le The maximum number is 127 REC Speci es a parameter with the following parameter options recsize Indicates the record size If you do not use the DEV parameter the default is DISC with 1023 records A positive number indicates words a ...

Page 91: ...n be a formal le designator preceded by an asterisk The information in the env le can contain speci cations for page size character fonts forms and other printer requirements to be used with the HP laser printing system The le must be in a suitable form for downloading to the printer For example to specify the environment le ACCTENV HPENV SYS to be used when printing enter FILE ACCTLIST DEV ACCTPP...

Page 92: ...or CCTL Indicates whether or not you are specifying carriage control characters NOCCTL the default indicates that you are not specifying carriage control characters in writes to the le CCTL indicates that you are specifying carriage control characters in writes to the le Operation Notes Usage You can enter this command from a session a job a program or in break mode Pressing 4Break5 does not a ect...

Page 93: ...nd OUTX as the actual les for the program Enter FILE SOURCE INX FILE DEST OUTX RUN MYPROG To send output to a new le FILEX that has 64 word xed length records and two records per block in ASCII code enter FILE DEST FILEX NEW REC 64 2 F ASCII RUN MYPROG Note that the le equation only modi es the speci ed items Related Commands BUILD LISTEQ RESET MPE iX Commands 2 81 ...

Page 94: ...The name must contain from one to eight alphanumeric characters beginning with an alphabetic character userpass Speci es a user password that your system manager optionally assigns The password must contain from one to eight alphanumeric characters beginning with an alphabetic character A slash must precede the user password acctname Speci es the account name that your system manager assigns The n...

Page 95: ...f the session used in checking against access restrictions imposed by the jobfence The value of this parameter becomes e ective at the time of logon The value of inputpriority can range from 1 lowest priority to 13 highest priority The default is 8 If you supply a value less than or equal to the current jobfence access is denied to the session HIPRI Enables you to either override the system jobfen...

Page 96: ... gured time the line drops You must redial and press 4Return5 again If you are already logged on and you enter the HELLO command you are logged o your current session and logged on to a new session In addition to the user and account names you may be required to provide a group name and one or more passwords Providing a group name The group you select at logon for your local le domain is known as ...

Page 97: ...r method of entering passwords so that they do not appear to others in your work area To use this method just enter the command string without the required password s the system will prompt you for the password s The system turns o character echo so that what you type does not appear on the screen If you enter the incorrect password the prompt reappears and you have two more opportunities to enter...

Page 98: ...he group password Enter the following command string at the MPE iX operating system prompt MPE XL HELLO ALPHA USER TECH XGROUP XPASS The system responds by displaying the following logon message HP3000 RELEASE V UU FF USER VERSION V UU FF WED May 1 1991 10 12 AM MPE XL HP31900 A 11 70 Copyright Hewlett Packard 1987 All Rights Reserved Related Commands BYE EXIT JOB JOBFENCE LIMIT SHOWJOB 2 86 MPE i...

Page 99: ...P command and the desired parameters directly or you can access the Help Facility subsystem and enter individual HELP commands from the subsystem Refer to Operation Notes for more information Syntax Direct access HELP 8 commandname 2 6 6 4 PARMS OPERATION EXAMPLE ALL 3 7 7 5 lename HELPSTUDY SUMMARY CLASS 9 Subsystem access HELP4Return5 8 commandname 2 6 6 4 PARMS OPERATION EXAMPLE ALL 3 7 7 5 HEL...

Page 100: ...name Speci es any existing le name When you specify this parameter with the command the system displays the contents of the le and a header indicating whether it is a command le or program le You cannot specify this parameter from within the Help Facility subsystem HELPMENU Displays the main menu of the Help Facility subsystem from which you can choose several options This automatically appears wh...

Page 101: ...t method is recommended when you want to obtain information about one command or if you want to display the contents of a le The subsystem method is recommended if you want to obtain information about several commands or prefer to interact with a friendlier screen driven information source To access the Help Facility directly you type the HELP command followed by any of the valid syntax parameters...

Page 102: ...y access description and syntax information for the ABORT command enter HELP ABORT The system responds by displaying ABORT Aborts current program or operation Syntax ABORT KEYWORDS PARMS OPERATION EXAMPLE 2 90 MPE iX Commands ...

Page 103: ... a commandname or HELPSTUDY SUMMARY A summary of changes in MPE iX CLASS Classes of Commands SESSIONS JOBS FILES SUBSYSTEMS ETC command name COMMAND entries by name command name keyword COMMAND entry with keyword PARMS OPERATION EXAMPLE HELPSTUDY A beginner s introduction to Help EXIT To leave the Help Facility You can use UPPERCASE or lowercase The name of this screen is HELPMENU MPE iX Commands ...

Page 104: ...BORT at the prompt located at the bottom of the screen as shown ABORT The system responds by displaying ABORT Aborts current program or operation Syntax ABORT KEYWORDS PARMS OPERATION EXAMPLE 2 92 MPE iX Commands ...

Page 105: ...scrolling the portion that you specified o This summary contains seven special topics FUNCTION summary of Help function NM commands that operate in native mode CM commands that have been enhanced for MPE iX UNSUPPORTED commands that are NOT SUPPORTED in MPE iX UNCHANGED commands that retained their function from MPE V E XLSYNTAX discusses SYNTAX FLEXIBILITY with the NM commands CLASS commands by c...

Page 106: ...VARS Return MANAGE JOBS SESSIONS JOBSESS Return MANAGE RESOURCES RESOURCES Return MANAGE THE SPOOLER SPOOLER Return MANAGE SYSTEM USER LOGGING LOGGING Return MANAGE VOLUME SETS VOLUMES Return SYSTEM PROGRAMMING PROGRAMMING Return CREATING AND MANAGING UDCs UDC Return LANGUAGES BASIC C FORTRAN LANGUAGES Return DATA COMMUNICATION DATACOMM Return You may at any time enter the name of a command to fin...

Page 107: ...e contents of a le named TEST enter HELP TEST The system responds by displaying the following USER DEFINED COMMAND FILE TEST PUB VOL This is a test file Additional lines follow Related Commands None MPE iX Commands 2 95 ...

Page 108: ... job identity The name must contain from one to eight alphanumeric characters beginning with an alphabetic character The default is that no job name is assigned username Speci es your user name established by your system administrator that enables you to log on to this account The name must contain from one to eight alphanumeric characters beginning with an alphabetic character userpass Speci es y...

Page 109: ...vel STREAM command The JOB command is speci ed as a rst level JOB command groupname Speci es the group name to be used for the local le domain and for CPU time charges as established by the system administrator The name must contain from one to eight alphanumeric characters beginning with an alphabetic character The default is the home group if one is assigned This parameter is required if a home ...

Page 110: ...xecution limit If you do not have either of these capabilities the system attempts to log you on using INPRI 13 and succeeds if the jobfence is 12 or less and if the job limit is not exceeded You can also specify HIPRI to override the job limit but you must have either SM or OP capability The system does not override the job limit automatically If you use the HIPRI parameter without SM or OP capab...

Page 111: ...ameter applies only to output destined for spooled output devices and is ignored for other output The value must range from 1 lowest priority to 13 highest priority When outputpriority is 1 output is always deferred To print output from disk use an outputpriority of 2 or greater The default is 8 If spooling logging is disabled the default is 13 numcopies Indicates the number of job listing copies ...

Page 112: ... If you omit either of these parameters or enter them incorrectly the system rejects your job and prints error messages on the standard listing device and the console Depending on how your system administrator has set up users on the system you may also have to supply a logon group name as well as user account and or group passwords Command process If the system accepts your job the system display...

Page 113: ...ATA ENGR 4 FILE MASTER DEV TAPE 5 FILE OUTPUT NEWFILE PUB TECH 6 RUN UPDPROG 7 EOJ 8 Note that the rst command is the JOB command and that an exclamation point precedes each command 3 Enter the KEEP and END commands to save your le and terminate the EDITOR subsystem KEEP MYJOB UNN END 4 Submit the job le for processing by using the STREAM command STREAM MYJOB Note that the le MYJOB remains on disk...

Page 114: ...JOB Related Commands EOJ JOBFENCE LIMIT STREAM STREAMS 2 102 MPE iX Commands ...

Page 115: ...o the priorityfence until you raise their input priority with the ALTJOB command or lower the jobfence Operation Notes Usage You can enter this command from a session a job a program or in break mode Pressing 4Break5 does not a ect this command You must enter this command from the console however you can enter this command from your terminal if your system administrator has used the ALLOW command ...

Page 116: ...t of the new jobfence SHOWJOB JOBNUM STATE IPRI JIN JLIST INTRODUCED JOB NAME S26 EXEC 20 20 THU 4 17P OPERATOR SYS J7 WAIT D 8 10S 12 THU 4 18P JOB1 FIELD SUPT J8 WAIT D 8 10S 12 THU 4 18P JOB2 FIELD SUPT 3 JOBS 0 INTRO 2 WAIT INCL 2 DEFERRED 1 EXEC INCL 1 SESSIONS 0 SUSP JOBFENCE 14 JLIMIT 5 SLIMIT 16 3 Reset the jobfence to 6 to allow waiting jobs to log on JOBFENCE 6 16 21 J7 34 LOGON FOR JOB1...

Page 117: ...JOBFENCE Related Commands ALTJOB HELLO JOB LIMIT SHOWJOB MPE iX Commands 2 105 ...

Page 118: ...ter value but not the other the limit changes only for the speci ed parameter Operation Notes Usage You can enter this command from a session a job a program or in break mode Pressing 4Break5 does not a ect this command You must enter this command from the console however you can enter this command from your terminal if your system administrator has used the ALLOW command which permits you to ente...

Page 119: ...sting job and session execution The number of jobs and sessions may already exceed the new limit that you specify when you enter this command however this does not abort currently executing jobs or sessions They continue to execute but no new jobs enter the executing state and no new sessions are initiated Examples To limit the number of sessions to 13 but retain the current job limit enter LIMIT ...

Page 120: ...RATOR SYS S26 EXEC 177 177 TUE 5 01A FUNKY RSPOOL S S96 EXEC QUIET 35 35 TUE 8 31A SLIDES SIMON 3 JOBS 0 INTRO 0 WAIT INCL 0 DEFERRED 3 EXC INCL 3 SESSIONS 0 SUSP JOBFENCE 6 JLIMIT 2 SLIMIT 15 Note the JLIMIT and SLIMIT elds showing that the new job limit is 2 and the new session limit is 15 Related Commands HELLO JOB JOBFENCE 2 108 MPE iX Commands ...

Page 121: ...eric character speci es zero or more alphanumeric characters Each wildcard character is counted toward the eight character limit for group account and le names list le Speci es the name of the output le The default is STDLIST a temporary le that cannot be overwritten by the BUILD command It is automatically speci ed as a new ASCII le with variable length records closed in the temporary domain and ...

Page 122: ...u can only list your logon account and cannot display your password Example To display information including the password for an account named HPXLII enter LISTACCT HPXLII PASS ACCOUNT HPXLII DISC SPACE 754115 SECTORS PASSWORD ACCTPASS CPU TIME 3330 SECONDS LOC ATTR 00000000 CONNECT TIME 102 MINUTES SECURITY READ ANY DISC LIMIT UNLIMITED WRITE AC CPU LIMIT UNLIMITED APPEND AC CONNECT TIME UNLIMITE...

Page 123: ...LISTACCT Related Commands ALTACCT LISTGROUP LISTUSER NEWACCT MPE iX Commands 2 111 ...

Page 124: ...98 PERMTEMP 9 3 2 USENAME 32 TREE 32 NOTREE 3 Parameters leset Speci es the set of les to be listed The default for leset is The leset parameter can be either in MPE or HFS syntax MPE Syntax MPE Groups containing only MPE les If leset does not begin with the dot or slash indicating HFS syntax it is parsed according to MPE syntax and has the following form lename groupname accountname Wildcards may...

Page 125: ... the logon account whereas LISTFILE lists all the les in the CWD which may be di erent from the logon group however only those les whose names are valid MPE names are displayed If the CWD is not an MPE group the information about the le is displayed in the new format as discussed below MPE Syntax MPE Groups containing HFS les You may have an MPE group that also contains les with HFS syntax for exa...

Page 126: ...he following set a z A Z 0 1 2 3 4 5 6 7 8 9 _ The le names cannot begin with a hyphen The following wildcards may also be used matches 0 to 255 characters matches one character matches one digit matches one character speci ed between the brackets if used within brackets the hyphen means a range of characters For example c g means all the characters between c and g inclusive The character on the l...

Page 127: ...sed to determine the le names that match All the directories and les that match leset are found and searched recursively to display the les and directories that match pattern For example if leset is SYS all les and subdirectories within SYS and all les and directories within those subdirectories are displayed In this case is assumed for pattern If leset does not end in a slash all of the les that ...

Page 128: ...MPE accounts MPE groups and HFS directories the lename ends in a slash The information about each le begins at column 2 after 1 space If the le name or pathname is long and the information cannot t on one record of the output le it continues from column 1 of the next record MPE accounts MPE groups and HFS directories have le labels associated with them just like files hence LISTFILE 2 and LISTFILE...

Page 129: ...other information 01 LABEL Shows only the le label in hexadecimal 0 FILES For each directory this option displays PATH absolute directory name ending in a slash Next for each HFS le within the directory it shows only the le name This is the default For each le the name of the le at most 255 characters is displayed in a multicolumn format 1 SUMMARY Displays the le name le code record size record fo...

Page 130: ...he le name record size extent size number of records access rights for the user and other le characteristics including the date created modi ed and last accessed The same information for MPE and HFS les is displayed except for the following di erences Fully quali ed MPE le name is replaced by an absolute pathname Creator eld displays the fully quali ed user ID user acct of the le owner The SECURIT...

Page 131: ...t that is KSAM SPOOL and symbolic links 6 QUALIFY Shows the absolute pathname of the le 7 UNIQUE Shows all le speci c data in LISTFILE 5 type format but does not show LISTFILE 3 data the le name is shown Format options 5 and 7 are data driven outputs that show le speci c information such as KSAM keys spooled device or symbolic links When you use option 5 and a le has no unique data only the option...

Page 132: ...d save it with a lename Thereafter you can select this le by entering LISTFILE SELEQ FILENAME In the above example the lename represents OBJECT DIR The OBJECT option applies to HFS les and may have any one of the following values ACCT Lists only the MPE ACCOUNT directory GROUP Lists only the MPE GROUP directory FILE Lists only the les and not directories groups accounts DIR Lists only directories ...

Page 133: ...HFS syntax The LISTFILE command displays only those le names which match the pattern For example LISTFILE SYS NAME OFF displays all the les groups directories under the SYS account that start with OFF off Off and so on If pattern is speci ed within single or double quotes it is case sensitive For example LISTFILE SYS NAME OFF displays all the les groups directories under the SYS account that start...

Page 134: ...y les The permanent les are listed before the temporary les USENAME The USENAME option applies only to HFS named lesets This option indicates that the name is to be used to determine how many levels to display If the leset ends in a slash then all the lower level objects based on select eq are to be displayed If the name does not end in a slash then only the objects at the speci ed level are displ...

Page 135: ... the le s home volume set PV is mounted Use This command may 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 display le names that do not follow MPE naming syntax For example LISTFILE 2 will not display 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 T...

Page 136: ... AF 199 199 16 64 1 HFS Examples Figure 2 3 illustrates a hierarchical directory structure In this gure directory names are shown as the character d plus a number for example d0 and le names are shown as the character f plus a number for example f1 The examples following Figure 2 3 assume the directory structure shown They also assume that the current working directory CWD is ACCT GROUP d0 2 124 M...

Page 137: ...t example the HPPROMPT variable has been set to show the current working directory changes directories using the CHDIR command and requests a listing of all les one level below the CWD d a c b hello manager acct group setvar hpprompt hpcwd ACCT GROUP chdir d0 CWD is ACCT GROUP d0 ACCT GROUP d0 listfile PATH ACCT GROUP d0 d1 d2 d3 f1 f2 f3 ACCT GROUP d0 MPE iX Commands 2 125 ...

Page 138: ...d3 80B AF 12 12 1 16 1 1 f1 80B AF 12 12 1 16 1 1 f2 80B AF 12 12 1 16 1 1 f3 In the next example a listing of all entries one level below the group by specifying the absolute pathname has been requested d a c b ACCT GROUP d0 listfile ACCT GROUP 2 PATH ACCT GROUP CODE LOGICAL RECORD SPACE FILENAME SIZE TYP EOF LIMIT R B SECTORS X MX 16W HBD 4 67107839 1 64 2 d0 ACCT GROUP d0 In the next example th...

Page 139: ...CCT GROUP d0 d2 d6 ACCT GROUP d0 d3 ACCT GROUP d0 d3 d7 ACCT GROUP d0 d3 d7 d9 The next example illustrates the use of the OBJECT ACCT parameter to show all accounts on the system d a c b ACCT GROUP d0 listfile seleq object acct format 6 ACCT SYS TELESUP TEST The next example illustrates the OBJECT GROUP parameter to show all groups on the system MPE iX Commands 2 127 ...

Page 140: ... group format qualify ACCT GROUP ACCT PUB SYS ALINE925 TELESUP PUB TEST PUB TEST SPOOL TEST SPOOLSTD TEST TEMPLATE ACCT GROUP d0 The next example illustrates the use of the OBJECT DIR parameter to show all directories on the system 2 128 MPE iX Commands ...

Page 141: ... d4 ACCT GROUP d0 d2 d5 ACCT GROUP d0 d2 d5 d8 ACCT GROUP d0 d2 d6 ACCT GROUP d0 d3 ACCT GROUP d0 d3 d7 ACCT GROUP d0 d3 d7 d9 ACCT PUB SYS SYS ALINE925 SYS ALINK925 TELESUP PUB TEST PUB TEST SPOOL TEST SPOOLSTD TEST TEMPLATE ACCT GROUP d0 The next example illustrates a summary listing format option 1 of all les in subdirectory d3 MPE iX Commands 2 129 ...

Page 142: ...d3 CODE LOGICAL RECORD FILENAME SIZE TYP EOF LIMIT 16W HBD 4 67107839 d7 80B AF 12 12 f10 80B AF 12 12 f7 80B AF 12 12 f8 80B AF 12 12 f9 ACCT GROUP d0 The next example illustrates a detail listing format option 3 of all les in subdirectory d3 2 130 MPE iX Commands ...

Page 143: ... ACCESSED WED JUL 22 1992 12 05 PM SEC OFFSET 0 LABEL ADDR VOLCLASS MPEXL_SYSTEM_VOLUME_SET DISC FILE ACCT GROUP d0 d3 f9 FILE CODE 0 FOPTIONS ASCII FIXED NOCCTL STD BLK FACTOR 1 OWNER REC SIZE 80 BYTES GROUP ID BLK SIZE 80 BYTES SECURITY READ EXT SIZE 13 SECT WRITE NUM REC 12 APPEND NUM SEC 16 LOCK NUM EXT 1 EXECUTE MAX REC 12 SECURITY IS ON MAX EXT 1 FLAGS NO ACCESSORS NUM LABELS 0 CREATED TUE J...

Page 144: ...READ EXT SIZE 0 SECT WRITE NUM REC 4 APPEND NUM SEC 64 LOCK NUM EXT 2 EXECUTE MAX REC 67107839 SECURITY IS ON FLAGS 1 ACCESSOR SHARED NUM LABELS 0 CREATED TUE JUL 21 1992 1 10 PM MAX LABELS 0 MODIFIED TUE JUL 21 1992 2 16 PM DISC DEV 2 ACCESSED WED JUL 22 1992 11 40 AM SEC OFFSET 0 LABEL ADDR 000000E1 0009A220 VOLCLASS MPEXL_SYSTEM_VOLUME_SET DISC ACCT GROUP d0 The next example illustrates the use...

Page 145: ...ECUTE SAVE FILE READ FCODE 0 WRITE SECURITY IS ON APPEND ACD EXISTS LOCK EXECUTE FOR MANAGER ACCT RACD TD RD CD DD ACCT GROUP d0 The next example illustrates the use of the FORMAT 2 ACD option to display the access contol de nition ACD for le f4 in subdirectory d2 Note that all users have read ACD RACD access for this le MPE iX Commands 2 133 ...

Page 146: ...LISTFILE d a c b ACCT GROUP d0 listfile d2 f4 2 PATH ACCT GROUP d0 d2 ACD ENTRIES FILENAME RACD f4 ACCT GROUP d0 Related Commands LISTF LISTF UDC LISTFTEMP 2 134 MPE iX Commands ...

Page 147: ...lphanumeric character speci es zero or more alphanumeric characters Each wildcard character is counted toward the eight character limit for group account and le names list le Speci es the name of the output le The default is STDLIST a temporary le that cannot be overwritten by the BUILD command It is automatically speci ed as a new ASCII le with variable length records closed in the temporary doma...

Page 148: ...tions If you have system manager SM capability you can display any group on the system If you have account manager AM capability you can display any group in your account If you have neither capability you can only display your logon group Example To display information including the password for a group named DEVELOP enter LISTGROUP DEVELOP PASS 2 136 MPE iX Commands ...

Page 149: ...SECONDS SECURITY READ GU CONNECT TIME 0 MINUTES WRITE GU DISC LIMIT UNLIMITED APPEND GU CPU LIMIT UNLIMITED LOCK GU CONNECT LIMIT UNLIMITED EXECUTE GU PRIV VOL n a SAVE GU FILE UFID 000D4001 80001050 000FF620 00000008 0000000A MOUNT REF CNT n a HOME VOL SET MPE_SYS_VOL_SET CAP IA BA Related Commands ALTGROUP LISTACCT LISTUSER NEWGROUP MPE iX Commands 2 137 ...

Page 150: ...eter are as follows Use optionally but if you use it make sure to include an I or O with the symbol O is assumed if you do not specify either I or O Use to specify all spool les Use I to specify all input spool les All input spool les reside in IN HPSPOOL Use O to specify all output spool les All output spool les reside in OUT HPSPOOL You must have account manager AM capability when specifying O i...

Page 151: ...mary If you specify the STATUS parameter the system only displays the status summary You cannot specify the DETAIL parameter with this parameter Operation Notes Usage You can enter this command from a session a job a program or in break mode Pressing 4Break5 aborts the execution of this command First line elds and description The rst line of the display for LISTSPF appears as shown in the followin...

Page 152: ...put spool le is being created an output spooled device has been opened and is being written to which generates an output spool le When the device closes the spool le enters the ready state READY An output spool le is ready to be printed or an input spool le is ready to be accessed ACTIVE An input spool le is being read from a stream le or a spooled device to a disk OPEN A JOB input spool le the ST...

Page 153: ... job le S indicates that you have speci ed SPSAVE for this spool le The spool le is saved in the OUT HPSPOOL group and account after the last copy prints P indicates that the spool le is private F indicates that the spool le has a forms message associated with it and requires special forms on which to print If a formid is present you can show its identity by specifying the DETAIL parameter and loo...

Page 154: ...that will use the input spool le as its STDIN le COPSRM Indicates the number of copies of this le that remain to be printed including any currently printing copy SECTS Indicates the number of sectors that the spool le occupies RECS Indicates the number of records in the spool le PAGES Indicates the number of physical pages in the spool le DATE Indicates the date that the le rst entered the ready s...

Page 155: ...the number of JOB input spool les the STDIN for a batch job that are being accessed by the job s CI process or the number of data input spool les that are being accessed by a process READY Indicates the number of input spool les ready to be accessed CREATE Indicates the number of output spool les being created DEFER Indicates the number of output spool les in a deferred state DELPND Indicates the ...

Page 156: ... instead of being deleted after printing This state occurs if you speci ed the SPSAVE option of the SPOOLF command when you created the spool le or when the spool le would have been deleted after its nal copy printed XFER Indicates the number of output spool les selected for transport from one network to another TOTAL IN FILES Indicates the total number of input spool les IN SECTORS Indicates the ...

Page 157: ...9 1 00000012 READY F DEV HPE 0128 J144 STDLIST 8 1 EPOC READY DEV HPE 01233 S1234 OUTLIST 0 1 FASTLP DEFER DEV HPE INPUT SPOOL FILES OUTPUT SPOOL FILES ACTIVE 0 CREATE 0 READY 2 OPEN 0 DEFER 1 SELECTED 3 READY 0 DELPND 0 SPSAVE 0 PRINT 1 XFER 0 PROBLM 0 TOTAL IN FILES 0 TOTAL OUTFILES 4 IN SECTORS 0 OUT SECTORS 5964 OUTFENCE 6 Single Line Display MPE iX Commands 2 145 ...

Page 158: ...T 9 1 00000012 READY F DEV HPE PAYCHECK TESTJOB 1 250 500 9 12 20 88 8 39 O128 J144 STDLIST 8 5 EPOC READY DEV HPE LPJOB 3 250 127 21 12 20 88 22 19 O1233 S1234 OUTLIST 0 1 FASTLP DEFER DEV HPE TESTJOB 1 250 500 9 12 20 88 8 39 I564 J164 STDIN 00000010 READY DEV HPE BATCHJOB 17 12 2 20 88 22 23 INPUT SPOOL FILES OUTPUT SPOOL FILES ACTIVE 0 CREATE 0 READY 2 OPEN 0 DEFER 1 SELECTED 3 READY 1 DELPND ...

Page 159: ...sponds by producing the following status display INPUT SPOOL FILES OUTPUT SPOOL FILES ACTIVE 0 CREATE 0 READY 2 OPEN 0 DEFER 1 SELECTED 3 READY 0 DELPND 0 SPSAVE 0 PRINT 1 XFER 0 PROBLM 0 TOTAL IN FILES 0 TOTAL OUTFILES 4 IN SECTORS 0 OUT SECTORS 1000 OUTFENCE 6 Status Display Related Commands LISTFILE PRINT SPOOLF SHOWIN SHOWOUT MPE iX Commands 2 147 ...

Page 160: ...racters to specify certain types of characters as follows speci es a single numeric character speci es a single alphanumeric character speci es zero or more alphanumeric characters Each wildcard character is counted toward the eight character limit for group account and le names list le Speci es the name of the output le The default is STDLIST PASS Permits those with AM and SM capability to see th...

Page 161: ... display information including the password for a user named PETE enter LISTUSER PETE PASS The system responds by printing the following information on your screen USER PETE HPXLII HOME GROUP DEVELOP PASSWORD MYPASS MAX PRI 150 LOC ATTR 00000000 LOGON CNT 1 WRITE GU CAP AM AL GL DI CV UV LG CS ND SF IA BA PH DS MR PM To display all users in an account named PRACTICE enter LISTUSER PRACTICE Related...

Page 162: ...ities to general users the system administrator should use this parameter for only one account manager The system administrator should use the NEWUSER command to assign additional users to the account The default for this user is that no password is assigned and capabilitylist is the same as the account capability The system administrator can later change the attributes of an account manager by us...

Page 163: ... Node manager SF Save files ND Access to nonshareable I O devices UV Use volumes CV Create volumes CS Use communication subsystem PS Programmatic sessions LG User logging PH Process handling DS Extra data segments MR Multiple RINS PM Privileged mode IA Interactive access BA Batch access The defaults are AM AL GL SF ND IA and BA MPE iX Commands 2 151 ...

Page 164: ...s L W Write implies A and L X Execute The user types are de ned as follows ANY Any user AC Member of this account only The default is no security restrictions at the account level You can specify two or more user or access types if you separate them with commas Operation Notes Usage You can enter this command from a session a job a program or in break mode Pressing 4Break5 does not a ect this comm...

Page 165: ...PUB group is initially assigned the same capability class attributes permanent le space limit CPU limit and connect time limit as the account but without a password Its initial security allows read R and execute X access to all users who successfully log on to the account and append A write W lock L and save S access to the account librarian AL and group users GU only These access provisions are a...

Page 166: ...NEWACCT Related Commands ALTACCT ALTUSER LISTACCT NEWGROUP NEWUSER 2 154 MPE iX Commands ...

Page 167: ...irectory named dir name All parent directories must already exist The dir name inherits the group ID GID from its parent directory and the user ID UID from the user creating the directory The special directory entries dot and dot dot are automatically created under dir name By default NEWDIR creates an MPE named directory This means that dir name must follow all MPE naming rules unless it is pre x...

Page 168: ...es create a directory called DIR1 In the rst example the directory is created by specifying the full pathname of the directory In the second example the directory is created by specifying the dir name groupname acctname Note that in the second example the dir name is shifted to uppercase d a c b NEWDIR MYACCT MYGRP DIR1 d a c b NEWDIR dir1 mygroup myacct The following example creates an HFS named ...

Page 169: ...he current working directory CWD Note that in this example the dir name is not shifted to uppercase d a c b NEWDIR dir1 The next example creates an MPE named directory called A in the group B d a c b NEWDIR a b Related Commands LISTFILE CHDIR PURGEDIR LISTDIR UDC FINDDIR UDC MPE iX Commands 2 157 ...

Page 170: ...use this parameter PASS Speci es the group password used for verifying logon access only The default is that no password is assigned CAP Lists capability class attributes consisting of any or all of the following BA Local batch access default DS Extra data segments IA Interactive access default MR Multiple RINS PH Process handling PM Privileged mode This list imposes a limit on program les belongi...

Page 171: ... implies A and L X Execute S Save The user types are de ned as follows ANY Any user AC Member of this account only GU Member of this group only AL Account librarian user only GL Group librarian user only You can specify two or more user or access types if you separate them with commas The defaults for the public group PUB are R X ANY A W L S AL GU The default for all other groups is R A W L X S GU...

Page 172: ...ver within account limits you can rede ne the group and user attributes and capabilities as well as those of the PUB group PUB group The PUB group is initially assigned the same capability class attributes permanent le space limit CPU limit and connect time limit as the account but without a password Its initial security allows read R and execute X access to all users ANY who successfully log on t...

Page 173: ...EWGROUP GROUP1 To create a new group named G2 in the account WISDOM and assign it process handling PH and multiple RINs MR capabilities while retaining the default capabilities enter NEWGROUP G2 WISDOM CAP PH MR IA BA Related Commands ALTGROUP LISTGROUP NEWACCT NEWUSER MPE iX Commands 2 161 ...

Page 174: ...a required parameter When specifying linkname you may not use wildcard characters le equations or name a system de ned le such as NULL sourceobject The path name to which a link is to be created The sourceobject does not need to exist when creating symbolic links This path must resolve to either a le group account or directory name Security provisions of sourceobject do not a ect the creation of s...

Page 175: ... that symbolic link is used as the name of the new link that is being created The NEWLINK command fails if the path represented by linkname points to a le or directory that already exists The following table lists all the CI commands that operate on les groups accounts or directories and are a ected by symbolic linking Keep in mind the following data points when using the table below Typically a s...

Page 176: ...K parameter may not name a symbolic name The TO parameter is not checked at all PURGE Yes This behaves di erently than the UNIX rm command PURGEACCT No No Link is not resolved Therefore operation is performed on the speci ed name If a symbolic link exists under the account that link i s not resolved and its target is not removed PURGEDIR Yes No Link is resolved before the operation is performed If...

Page 177: ...d Note that REPORT treats its rst parameter as a group nam e Therefore if a link name is speci ed that name is treated as a group name regardless of the type of its target RESTORE No Link is not resolved Therefore operation is performed on the name speci ed STORE No Link is not resolved Therefore operation is performed on the name speci ed MPE iX Commands 2 165 ...

Page 178: ...se the positional parameters and enter NEWLINK PAYCODE PAYROLL CODE SOFTWARE In this example the le PAYCODE PUB ACCT1 will be created as a symbolic link to le PAYROLL CODE SOFTWARE The user now can access PAYROLL SAFE SOFTWARE through PAYCODE For example the user may enter the following command PRINT PAYCODE This command will print the contents of the le PAYROLL CODE SOFTWARE given that this le al...

Page 179: ... the current logon group or CWD NEWLINK COMMON COMMON CODE SOFTWARE PRINT COMMON Suppose that a user is currently logged on as USER1 in the group PUB SOFTWARE To access the les in ACCT1 dir1 directory without entering the full path name each time USER1 may establish a link named morecode to that directory as following NEWLINK LINK morecode TO ACCT1 dir1 To get a list of the les under acct1 dir1 th...

Page 180: ...T1 PUB softPUB TO SOFTWARE PUB Creates ACCT1 PUB softPUB SOFTWARE PUB as a link to group PUB in SOFTWARE account NEWLINK LINK FILE9 PUB ACCT1 TO Creates FILE9 as a link to the root Part 2 Relative symbolic links For these examples assume that CWD SOFTWARE CODE dir2 NEWLINK LINK F1 TO f1 Creates SOFTWARE CODE F1 f1 as a link to a file NEWLINK LINK F2 CODE TO f2 Creates SOFTWARE CODE F2 f2 as a link...

Page 181: ...NEWLINK Related Commands PURGELINK PURGE LISTFILE MPE iX Commands 2 169 ...

Page 182: ...of from one to eight alphanumeric characters beginning with an alphabetic character acctname Speci es the account in which the user is to reside You must have account manager AM capability to use this parameter PASS Speci es the user password used for verifying logon access only The password must consist of from one to eight alphanumeric characters beginning with an alphabetic character The defaul...

Page 183: ...exceed those assigned to the account Any capabilities removed from the account are denied to the user The user s capabilities are always veri ed to be a subset of the account s capabilities at logon This prevents a user from having a capability not assigned to the account HOME Speci es the name of an existing group to be assigned as the user s home group The rst user established when an account is...

Page 184: ...manager SM capability to enter this command You must have system manager SM capability to specify a user in an account other than your own Example To de ne a new user named LHSMITH in the account FINANCE assign a password of SMITTY and assign a home group of HOMEGPX enter NEWUSER LHSMITH FINANCE PASS SMITTY HOME HOMEGPX Related Commands ALTUSER LISTUSER NEWACCT NEWGROUP 2 172 MPE iX Commands ...

Page 185: ...y state only if their outputpriority is higher than the current outfence LDEV Speci es the logical device number ldev of a printer You can use this parameter to selectively defer all output spool les except those currently being printed by the speci ed LDEV See Examples DEV Consists of the following parameter values ldev Speci es the logical device number of an output device devclass Speci es a de...

Page 186: ...o 14 You can prevent a subset of spool les from printing by setting the outfence higher than the outputpriority of any spool le in the group You can alter the printing priority of a single le without a ecting the entire system by changing the output priority of the speci c spool le s using the ALTSPOOLFILE or SPOOLF command Examples To temporarily defer all output spool les except those waiting to...

Page 187: ...2 SPOOFLES 2 DEFERRED 3 OPENED INCLUDING 2 SPOOFLES 0 LOCKED INCLUDING 0 SPOOFLES 4 SPOOFLES 2024 SECTORS OUTFENCE 14 OUTFENCE 7 FOR LDEV 6 The summary statistics at the bottom of the listing immediately re ect the new outfence After all currently active spool les are nished no les directed toward a device other than LDEV 6 can become active 3 Reset the outfence for all output spool les as shown O...

Page 188: ...OUTFENCE Related Commands ALTSPOOLFILE LISTSPF SHOWIN SHOWOUT SPOOLER SPOOLF 2 176 MPE iX Commands ...

Page 189: ... command from a session or in break mode You cannot use this command if you redirect STDIN or STDLIST Example To change an existing password enter PASSWORD The system responds by displaying the following prompts ENTER OLD USER PASSWORD ENTER NEW USER PASSWORD ENTER NEW USER PASSWORD AGAIN PASSWORD WAS CHANGED SUCCESSFULLY For security purposes the system does not echo your input responses Related ...

Page 190: ... in MPE or HFS syntax and may name a symbolic link that resolves to a le name The following points apply to this parameter You can specify a temporary or a permanent disk le with this parameter File equations are ignored unless an asterisk precedes lename indicating a backreference The lename can be STDIN or STDINX the default If you do not specify a le name PRINT takes its input from STDINX and c...

Page 191: ...s the execution of this command Batch print jobs For batch jobs in which lename defaults to STDINX some commands such as EOD EOF JOB EOJ and DATA do not execute as part of the original job when they follow the PRINT command For example PRINT command reads all job input up to the EOD line At that point the PRINT command is nished and the remaining JOB stream commands are executed Examples To send t...

Page 192: ...PRINT STDIN TAILB PARM FILE LAST 5 PRINT FILE START LAST EOD SAVE TAILB Since the default is temporary the SAVE command permanently saves the le TAILB Related Commands COPY EDITOR FCOPY 2 180 MPE iX Commands ...

Page 193: ... SYS TEMP Speci es that the le is a temporary le in the job session temporary le domain You can specify a lename in MPE or HFS syntax and may name a symbolic link that resolves to a lename You must enter this parameter to delete a temporary le The default is that a permanent le is assumed Operation Notes Usage You can enter this command from a session a job a program or in break mode Pressing 4Bre...

Page 194: ... below Examples To delete a permanent le named PFILE enter PURGE PFILE To purge multiple les using wildcards PURGE users jeff bin FILES file 3 FILES matched Continue PURGE YES NO yes 3 selected 3 succeeded 0 failed To purge multiple les interactively using wildcards To purge a number of les one at a time in an interactive mode so that you can skip a le or stop your purge you can use the CONFIRMALL...

Page 195: ...ith log followed by any number from 0 9 followed by any number of alphanumeric characters PURGE log 10 FILES matched Continue PURGE YES NO yes 10 selected 9 succeeded 1 failed Since the PURGE command does not remove the currently opened log le the command always returns 1 failed Related Commands ALTSEC BUILD LISTFILE LISTSPF MPE iX Commands 2 183 ...

Page 196: ...ge You can enter this command from a session a job a program or in break mode Pressing 4Break5 does not a ect this command You must have system manager SM capability to enter this command When to purge an account To completely purge an account you must enter PURGEACCT when the account is inactive If you enter the command while the account is in use the account remains on the system and active user...

Page 197: ...following order 1 users 2 volume set de nitions 3 les 4 groups 5 the account Caution It is not advisable to purge the SYS account because you can destroy critical les by doing so Examples To remove an account named EXCESS enter PURGEACCT EXCESS ACCT EXCESS TO BE PURGED YES NO YES Related Commands LISTACCT NEWACCT PURGEGROUP PURGEUSER MPE iX Commands 2 185 ...

Page 198: ...es that dir name alone controls whether or not all levels of directories and les are deleted If dir name is an HFS name and ends in a slash then it and all objects under it are deleted If dir name does not end in a slash then only dir name is purged assuming it is empty USENAME only applies to HFS named directories and is ignored for MPE named directories TREE Causes all objects below and includin...

Page 199: ...ir name from being deleted to be displayed on STDLIST The object le or directory name is shown followed by the error message By default lower level errors are not displayed NOSHOWERRORS Suppresses the display of low level errors NOSHOWERRORS is the default Use You can issue the PURGEDIR command from a job a session a program or in break mode Pressing 4Break5 terminates execution of this command Yo...

Page 200: ...REE purge may be requested as follows 1 Specify the TREE option The dir name parameter does not control a multilevel purge in this case This is the only choice available if dir name is an MPE name 2 If dir name is an HFS name ends in a slash and the NOTREE option is not requested then a TREE purge occurs The dir name parameter cannot reference root because purging root is undesirable and most like...

Page 201: ...es each purged le and directory name to be displayed on STDLIST For example d a c b PURGEDIR mydir TREE SHOW mydir abc mydir dir1 dir2 file1 mydir dir1 dir2 file2 mydir dir1 dir2 mydir dir1 f1 mydir dir1 f2 mydir dir1 mydir file1 mydir The SHOWERRORS option causes any error that prevents an object from being deleted to be displayed to STDLIST after the object name is displayed Object names are onl...

Page 202: ... NOTREE option overrides directory name ending in a CIWARN 9041 The following examples purge dir1 and all objects below dir1 d a c b PURGEDIR MYACCT MYGRP dir1 d a c b PURGEDIR MYACCT MYGRP dir1 TREE The next example shows the command to purge MYDIR d a c b PURGEDIR mydir 2 190 MPE iX Commands ...

Page 203: ...ample illustrates the SHOW and TREE options d a c b PURGEDIR dir SHOW TREE DIR A DIR B DIR dir1 A DIR dir1 B DIR dir1 DIR C DIR d a c b PURGEDIR dir1 dir2 SHOW TREE dir1 dir2 file1 dir1 dir2 file2 dir1 dir2 d a c b PURGEDIR foo show foo dir1_below_foo f1 foo dir1_below_foo f2 foo dir1_below_foo foo MPE iX Commands 2 191 ...

Page 204: ...low these directories d a c b PURGEDIR tmp TREE The following command purges all directories under the CWD with names ending with tmp and all objects below these directories d a c b PURGEDIR tmp The following command purges all empty directories rooted to a b d a c b PURGEDIR a b The following command purges all directories rooted to CWD a b and all objects below these directories d a c b PURGEDIR...

Page 205: ...o delete all directories under the CWD with names beginning with TMP and all objects below these directories purgedir TMP TREE To delete all directories under the CWD with names ending with TMP and all objects below these directories purgedir TMP When wildcards are speci ed with dir name then RD access is required to the parent directory of each wildcard component If the purge is multilevel then T...

Page 206: ... located System manager SM capability is required to use this parameter Operation Notes Usage You can enter this command from a session a job a program or in break mode Pressing 4Break5 does not a ect this command You must have system manager SM or account manager AM capability to enter this command When to purge a group To completely purge a group you must enter PURGEGROUP when the group and its ...

Page 207: ...e the group in this case reenter the PURGEGROUP command when neither the group nor its les are in use Caution Do not attempt to purge the PUB group of the SYS account You cannot completely purge the public group of the system account PUB SYS If you specify this group in the groupname parameter all nonsystem and inactive les are purged which seriously impairs the proper functioning of the entire sy...

Page 208: ...oup account or directory Links are established through the NEWLINK command and they are removed through the PURGELINK command The PURGELINK command may be issued from a session job program or in BREAK PURGELINK requires Traverse Directory TD and Delete Directory entry DD permissions EXAMPLE For the following examples assume that a user is currently logged on as USER1 in the group SAFE COMPANY To r...

Page 209: ...PURGELINK Related Commands NEWLINK PURGE PURGEDIR LISTFILE MPE iX Commands 2 197 ...

Page 210: ...he default is the logon account of the account manager System manager SM capability is required to use this parameter Operation Notes Usage You can enter this command from a session a job a program or in break mode Pressing 4Break5 does not a ect this command You must have system manager SM or account manager AM capability to enter this command You cannot purge a user if he or she is currently log...

Page 211: ...stem The following choices are available for deleting les The system administrator with system manager SM capability can remove the les account by entering the PURGEACCT command Someone with account manager AM capability can remove the les group by entering the PURGEGROUP command Anyone can enter the PURGE command for each le to be deleted Example To remove a user named USER1 enter PURGEUSER USER1...

Page 212: ...nter the RECALL command only if your system administrator has used the ALLOW command or ASSOCIATE command which permits you to enter this command Di erences between RECALL and 4Ctrl5A RECALL Both of these commands function identically except that you can enter 4Ctrl5A RECALL only from the console and not from a job or program The sign appears when you press 4Ctrl54A5 Pressing these keys enables yo...

Page 213: ... CIWARN 3020 If a request is pending for a reply a message similar to the following appears THE FOLLOWING REPLIES ARE PENDING 10 05 J19 15 LDEV FOR L00576 ON TAPE1600 NUM To display all pending console messages from the console enter 4Ctrl54A5 RECALL If no requests are pending for a reply the following message appears NO REQUESTS PENDING SYS 15 Related Commands REPLY MPE iX Commands 2 201 ...

Page 214: ...as the form lename lockword groupname acctname If the le has a lockword you must specify it otherwise the system prompts you for it If you do not specify groupname acctname the system assumes the logon group and account HFS Syntax If the lename begins with a dot or a slash it is parsed according to HFS syntax Operation Notes Usage You can enter this command from a session a job a program or in bre...

Page 215: ...a ect the following access controls Privileged les You cannot release privileged les Lockwords You cannot override lockwords ACDs This command does not a ect the security on les with access control de nitions However if you remove the ACD the le is released Refer to the ALTSEC command in this book for more information about ACDs Example To release all security provisions for a le named FILE1 in yo...

Page 216: ...es the new name of the le in the same format as old lereference If you specify acctname the logon account must belong to you If you specify groupname you must have SAVE access to the group name If you omit acctname and or groupname the logon account and or group are assumed Operation Notes Usage You can enter this command from a session a job a program or in break mode Pressing 4Break5 does not a ...

Page 217: ... to the spooler print queues Examples To change the name of a le named OLDFILE to a le named NEWFILE enter RENAME OLDFILE NEWFILE To change the lockword of the le FILE2 from LOCKA to LOCKB enter RENAME FILE2 LOCKA FILE2 LOCKB To move a le from GROUP1 to GROUP2 within the same account enter RENAME MYFILE GROUP1 MYFILE GROUP2 To apply the command as shown above you must have save access to the group...

Page 218: ...E NUM reply Speci es one of three reply types shown in parentheses in the message NUM Supply a logical device number Y N Supply YES Y or NO N MAX CHARS nn Supply a string expression consisting of nn characters or fewer This reply type is only used for labeled tapes Operation Notes Usage You can enter this command from a session a job a program or in break mode Pressing 4Break5 does not a ect this ...

Page 219: ...ng to requests Programs requesting the use of a device waiting for a reply remain suspended inde nitely and cannot be aborted until you enter the REPLY or ABORT command If you cannot reply as requested such as when a particular device is nonexistent use 0 if NUM is requested or use N if Y N is requested This action aborts the pending resource request Examples To respond to the following standard t...

Page 220: ...REPLY 4Ctrl5A REPLY Related Commands ALLOW ALTSPOOLFILE ASSOCIATE RECALL SYSGEN AUTOREPLY 2 208 MPE iX Commands ...

Page 221: ...ter values and their capability requirements are as follows group Reports on the speci ed group in the logon account This is the default for standard users who can specify only their logon group Reports on all groups in the logon account This is the default for account managers and only users with account manager AM or system manager SM capability can use this parameter value group acct Reports on...

Page 222: ...o all names that include ABC anywhere in the name Speci es one numeric character A translates to all names that begin with A followed by any three digits followed by any combination of zero to four alphanumeric characters Speci es one alphanumeric character A translates to all the three character names that begin with A followed by an alphanumeric followed by a digit You can use these characters a...

Page 223: ...designator of the output le where the information is to be written The default is STDLIST but you can redirect output with a le equation as follows FILE LIST1 DEV LP REPORT LIST1 Operation Notes Usage You can enter this command from a session a job a program or in break mode Pressing 4Break5 aborts execution of this command You must have account manager AM capability to enter this command for an e...

Page 224: ...123 5302 The information in the display shows usage counts and limits for permanent le space in sectors CPU time in seconds and session connect time in minutes The le space usage count re ects the number of sectors used when you enter the command however CPU time and connect time usage appear as they were immediately before the beginning of the current job Two asterisks under the LIMIT column indi...

Page 225: ...ACCOUNT accountname 2 3 KEEP NOKEEP OLDDATE NEWDATE ONERROR QUIT SKIP 2 DIRECTORY 3 2 LISTDIR 3 2 TREE 32 NOTREE 3 Parameters restore le Speci es the name of the magnetic tape le that contains the les that you want to restore to the system You must backreference the le by using an asterisk First you must use a le equation before entering the RESTORE command For instance if you want to restore les ...

Page 226: ...m can be indirect le or leset indirect le A le name that backreferences a disk le The syntax is indirect le This le may consist of leset s and option s but only options can appear after the rst semicolon on each line An option speci ed on one line will operate on all les in the lesetlist leset Speci es a set of les to be restored and optionally those les to be excluded from the RESTORE operation T...

Page 227: ...PE syntax is as follows lename groupname accountname A lockword may be speci ed for les to be stored in the form lename lockword group account The HFS syntax is as follows dir lev 1 dir lev 2 dir lev i ledesig or dir lev i dir lev j dir lev k ledesig If the name begins with a dot then it is fully quali ed by replacing the dot with the current working directory CWD Each of the components dir lev i ...

Page 228: ...ing with the character n n Restore all les starting with character n followed by up to seven digits useful for restoring all EDIT 3000 temporary les n x Restore all les starting with the character n and ending with the character x n Restore all les whose second character is n n Restore all two character les starting with the character n n Restore all two character les ending with the character n A...

Page 229: ...ht bracket When speci ed between two characters the hyphen implies a range of characters When a MPE name component is a single wildcard the will be folded to include all MPE and HFS named les at that level and below To speci y only MPE named les use instead A leset may be entered in any of the following formats and may use wildcard characters Equivalent MPE and HFS formats are grouped together as ...

Page 230: ...it in all the groups in one particular account DEVICE Speci es the device on which the le resides It takes one of two forms devclass or ldn devclass Speci es the type of device If devclass is speci ed the le is allocated to the home volume set within the speci ed device class of the group into which a le is being restored ldn Speci es a particular logical device number ldn corresponding to a parti...

Page 231: ...ine printer showparmlist Tells RESTORE what information to display for the les that are restored If you specify SHOW and omit showparmlist then the default is SHORT if the recordsize of SYSLIST is less than 132 characters or LONG if the recordsize is equal to or greater than 132 characters The format for showparmlist is showparm showparm showparm where showparm may be one of the options described ...

Page 232: ...s the creation date the last date of access and the last date of modi cation SECURITY Displays the le creator and the security matrix PATH Forces all le listings to be in HFS format The full HFS pathname is displayed instead of MPE style names OFFLINE Sends an additional copy to the device OFFLINE which defaults to device LP LOCAL Speci es that les will be restored regardless of the system s direc...

Page 233: ...es four dates in each le s le label the creation date modi cation date last access date and the allocation date The allocation time is also stored in the label NEWDATE changes all dates and times to the date and time that RESTORE was executed OLDDATE retains the original modi cation and last access dates but changes the creation and allocation dates to the date of the RESTORE procedure Default is ...

Page 234: ...match your lesetlist are displayed The security restrictions that apply to lesetlist apply here too The output goes to SYSLIST TREE The tree option forces every HFS syntax le set to be scanned recursively irrespective of the slash speci ed or not at the end of the le set NOTREE The notree option forces every HFS syntax le set not to be scanned recursively irrespective of the slash speci ed or not ...

Page 235: ...M capability to use this command for privileged les Command process The output generated by RESTORE goes to a le whose formal designator is SYSLIST If a disk or directory error is encountered while updating the directory updating the Disc Free Space tables or writing the data to the le the error is reported to SYSLIST defaults to STDLIST and RESTORE will continue Any le belonging to a group whose ...

Page 236: ...on Users without SM or OP capability must always supply the lockword The exception is AM If you have AM and you are working in your own account you do not have to supply the lockword If RESTORE is executed as a job however all users lacking SM OP or AM capability must supply le lockwords When the RUN command is used the system de ned JCW CIERROR will not be changed even if the RESTORE aborts When ...

Page 237: ...PE RESTORE T KEEP SHOW In response the system operator receives a request to mount the tape identi ed as T If a le on T already exists in the system it will not be restored because the KEEP parameter was speci ed To restore a le ABC without specifying a restore le no le equation need be used For example RESTORE ABC PUB SYS SHOW STORE RESTORE VERSION A 20 03 C 1986 HEWLETT PACKARD CO FRI APR 12 198...

Page 238: ... CO WED DEC 15 1993 7 16 PM WARNING YOUR DEFAULT FILESET BECOMES SINCE YOU HAVE OP OR SM CAPABILITY S R 1911 To have the list of restored les printed on a line printer enter FILE SYSLIST DEV LP FILE T DEV TAPE RESTORE T SHOW To restore only a subset of the leset enter RESTORE T PUB SYS Restores all les except those in the PUB group of the SYS account Related Commands STORE VSTORE REPLY RECALL 2 22...

Page 239: ...an RESUME If you enter a program or subsystem command after pressing 4Break5 the command interpreter prints the following message on your terminal ABORT YES NO If you respond YES to the message the command interpreter aborts the currently suspended program If you respond NO to the message the command interpreter prints the message COMMAND NOT ALLOWED IN BREAK and prompts you for another command If...

Page 240: ...rogram at the point of interruption do the following 1 Enter the following command RESUME The system responds by displaying the following message READ PENDING 2 Press 4Return5 to resume the program Related Commands ABORT 2 228 MPE iX Commands ...

Page 241: ...u can enter this command from a session a job a program or in break mode Pressing 4Break5 does not a ect this command You must enter this command from the console You can only enter this command from a terminal other than the console under one of the following conditions The JOBSECURITY command is set to LOW and Jnnn refers to a job logged on to your user account or account if you are the account ...

Page 242: ... SHOWJOB SUSP The system responds by displaying the following message JOBNUM STATE INPRI JIN JLIST INTRODUCED JOB NAME 68 SUSP 105 LP WED 7 56AM TEST USER ACCT 2 Enter the following command to resume processing job number 68 RESUMEJOB J68 Related Commands ABORTJOB ALLOW BREAKJOB JOBSECURITY SHOWJOB 2 230 MPE iX Commands ...

Page 243: ...uired parameter If you specify any other parameters they override the default parameters only for the current program execution The prog le name may be an HFS lename PARM Speci es a value parameternum that you can pass to the program as a general parameter for control or other purposes If you do not specify the parameter the default value is zero 0 The PARM value is limited to a signed 15 bit deci...

Page 244: ...he program resides INFO Enables you to pass an ASCII string quotedstring to the program to be run You must delimit the string with a matching pair of quotation marks either or If you want a quotation mark to appear within the string you must repeat it For instance you must type can t as can t and program must appear as program Including delimiters the maximum length of the string is 255 characters...

Page 245: ...ng after the equal sign STDLIST 4Return5 for instance then STDLIST defaults to the standard list device for your session terminal screen or job job listing The choices for this parameter are as follows formaldesig Indicates the formal le designator for a le previously speci ed in a le equation leref Indicates the name of an existing permanent or temporary disk le NEW Means that the le name cannot ...

Page 246: ...RUN command by omitting the command name RUN and entering the name of the program along with either the INFO or PARM parameters No other RUN command parameters are supported The native mode parser rather than the compatibility mode parser is used when you enter the implied form of the command Consequently you can use quotes or with the program le name and or the INFO parameter Quotes are not requi...

Page 247: ... AND with an extra pair of quotation marks resulting in the following string passed to the program A TEST WITH AND CHARACTERS To pass the same string to the program using the implied form of the command enter MYPROG A TEST WITH AND CHARACTERS or MYPROG A TEST WITH AND CHARACTERS Related Commands LINK PREP XEQ MPE iX Commands 2 235 ...

Page 248: ...rd groupname acctname If the le has a lockword you must specify it otherwise the system prompts you for it If you do not specify groupname acctname the system assumes the logon group and account HFS Syntax If the lename begins with a dot or a slash it is parsed according to HFS syntax Operation Notes Usage You can enter this command from a session a job a program or in break mode Pressing 4Break5 ...

Page 249: ...mand in this book for more information Access control de nition An access control de nition ACD overrides le access controls whether or not you have released or secured the le Example To reinstate le access control previously in e ect for the le named FILE1 enter SECURE FILE1 Related Commands ALTSEC LISTF LISTFILE RELEASE MPE iX Commands 2 237 ...

Page 250: ...oblems if the system date and time are too close to the base time of midnight January 1 1970 Therefore for proper system operation this command requires the date and time to be later than ten minutes past midnight on January 1 1970 correction spec An integer specifying the desired change in the system time The units are seconds Thus a positive correction will cause the system clock to advance by t...

Page 251: ...l remain this option does not undo a correction which has already been accomplished See the Operation Notes and Examples sections for details Operation Notes You can use the SETCLOCK command to change the system time or to change the system s time zone Changing the system time or time zone does not a ect any interval timers in e ect Thus a PAUSE for a given time duration will maintain that same du...

Page 252: ...justed forward or backward by the amount of the correction This adjustment is always gradual Time Zone If the Time Zone form is used local time is adjusted to match that of the speci ed time zone In addition the system time zone o set is changed to re ect the new time zone The Use of The Time Zone O set On the HP3000 Universal Time GMT is calculated by starting with local time and adding or subtra...

Page 253: ...ime Change Works Whether the Date Time or a Correction form is used the default method of changing the time is to gradually speed up or slow down the system clock until the change is achieved Thus even when a previous time is requested the system clock will still move forward although at a slower pace than real time This slower pace will continue until the desired time catches up with the system c...

Page 254: ...ameter permits immediate forward or backward time changes However several dangerous situations can occur Any applications which rely on the forward progression of time may give inconsistent results if the time is immediately set backwards Such applications include the processing of timestamped transactions in which the sequence of those transactions is important In order to recover data in case of...

Page 255: ... precedes that of the main le Thus the changed le will not be included in the recompilation This list is only meant to include a few of the dangers associated with an immediate time change this list does not represent all of the problems likely to be encountered Therefore if the NOW option must be used it should be used only with a full knowledge of its e ects on the system s workload Use You can ...

Page 256: ...be consumed SETCLOCK CORRECTION 3600 SHOWCLOCK SYSTEM TIME FRI JUL 24 1987 8 47 35 AM CURRENT TIME CORRECTION 3568 SECONDS TIME ZONE 7 HOURS 0 MINUTES WESTERN HEMISPHERE SETCLOCK CANCEL CORRECTION OF 3550 SECONDS HAS BEEN CANCELLED SHOWCLOCK SYSTEM TIME FRI JUL 24 1987 8 52 53 AM CURRENT TIME CORRECTION 0 SECONDS TIME ZONE 7 HOURS 0 MINUTES WESTERN HEMISPHERE Note that in the example above the sys...

Page 257: ...0 MINUTES WESTERN HEMISPHERE Moving from Daylight Savings Time to Standard Time The following example illustrates changing the system time zone o set from 7 hours 00 minutes in the Western Hemisphere Paci c Daylight Savings Time back to 8 hours 00 minutes in the Western Hemisphere Paci c Standard Time This command will cause local time to slow down until it loses one hour Users of Universal Time w...

Page 258: ...t and time zone See the SETCLOCK command for information about time correction and time zone Use You can issue this command from a session job program or in BREAK Pressing 4Break5 has no e ect on this command Example SHOWCLOCK SYSTEM TIME FRI JUL 24 1987 8 47 35 AM CURRENT TIME CORRECTION 3428 seconds TIME ZONE 7 HOURS 0 MINUTES WESTERN HEMISPHERE Related Commands SHOWTIME 2 246 MPE iX Commands ...

Page 259: ... or the classname parameter the system displays status information for all devices on the system classname Speci es the class name of device s for which status information is to be displayed This name can apply to several devices Without this parameter or the ldev parameter the system displays status information for all devices on the system Operation Notes Usage You can enter this command from a ...

Page 260: ...Speci es the logical device number and can include one of the following J Accepts jobs D Accepts data A Accepts jobs and data AVAIL Lists the availability of devices and disks as follows AVAIL The device is available as a real nonshareable device SPOOLED The device is available for input or output spooling UNAVAIL The device is unavailable it is controlled by a job a session or a system process su...

Page 261: ...rship Jnnn The indicated job controls ownership Snnn The indicated session controls ownership nn FILES nn number of les are currently in use on a disk DOWN The device is o ine as requested by the system administrator with the DOWN command DP The device is being taken o ine A DOWN command operation is pending VOLID Speci es the volume identi cation and can include one of the following IBM The named...

Page 262: ...that the system administrator has established with the ASSOCIATE command Examples To display the status of the device identi ed by logical device number 5 enter SHOWDEV 5 LDEV AVAIL OWNERSHIP VOLID DEN ASSOCIATION 5 SPOOLED SPOOLER OUT To display the status of all devices of the device class CARD enter SHOWDEV CARD LDEV AVAIL OWNERSHIP VOLID DEN ASSOCIATION 6 A AVAIL Related Commands ASSOCIATE DOW...

Page 263: ...as described under Operation Notes The default is that the status information for all jobs and sessions appears Jnnn Speci es the job number assigned by the system of the job for which status information is to be displayed The information appears as described under Operation Notes The default is that the status information for all jobs and sessions appears STATUS Lists the number of jobs and sessi...

Page 264: ...o be displayed Use one of the following options J Displays status information for all jobs S Displays status information for all sessions Displays status information for all jobs and sessions This is the default jsname username acctname The jsname is an optional user assigned name The username is the user name that the account manager establishes The acctname is the name of the account that the sy...

Page 265: ...the formal le designator of the le on which the output listing is written This parameter requires a backreference to a le equation The default characteristics of list le are that it is a temporary le has a record size of 256 bytes is blocked one record per block has carriage control CCTL and displays the date and time You can override the default characteristics by using the FILE command Operation...

Page 266: ...4 PAPERS JON OSE J23 SCHED 8 10 PP 5 25 91 8 01 REPORT MGR OSE J25 SCHED 8 10 LP 7 12 91 18 05 TEXT MGR LPUE 3 JOBS DISPLAYED JOBFENCE 7 JLIMIT 2 SLIMIT 20 In the output shown above the STATE eld shows that the job is scheduled The SCHEDULED INTRO eld shows the time and date that the job is to be introduced to the system Note that the scheduled jobs are listed in the order in which they are to be ...

Page 267: ...FENCE 2 JLIMIT 1 SLIMIT 16 To determine the number of jobs and sessions in each processing state the current jobfence and the job and session limits enter SHOWJOB STATUS 6 JOBS 0 INTRO 0 WAIT INCL 0 DEFERRED 6 EXEC INCL 6 SESSIONS 0 SUSP JOBFENCE 0 JLIMIT 3 SLIMIT 16 To override the default characteristics of list le with the FILE command and then show the output produced with the new list le char...

Page 268: ...7 MON 6 37A USER PUBS S47 EXEC 10S LP MON 7 26A SUPPORT DOC S48 EXEC 102 102 MON 7 28A USER TECH J19 EXEC 28 28 MON 6 41A JON OSE S49 EXEC 34 34 MON 7 31A TEXT LPUE J21 EXEC 10S LP MON 7 15A DELIVER MAIL MAIL J22 EXEC 10S LP MON 7 14A RSPOOLJ RSPOOL SYS 8 JOBS DISPLAYED 0 INTRO 0 WAIT INCL 0 DEFERRED 8 EXEC INCL 5 SESSIONS 0 SUSP JOBFENCE 6 JLIMIT 4 SLIMIT 50 EOF FOUND IN FROMFILE AFTER RECORD 17 ...

Page 269: ...tializing After initialization is complete the state changes to EXEC The number of jobs and sessions shown in the EXEC state is the sum of the jobs and sessions in both EXEC and EXEC states Related Commands ABORTJOB ALTJOB BREAKJOB JOBFENCE LIMIT RESUMEJOB SHOWPROC MPE iX Commands 2 257 ...

Page 270: ...e logon group name user name release number product version user version current time and date logon time CPU time consumed connection time LDEV number Syntax SHOWME Parameters None Operation Notes Usage You can enter this command from a session a job a program or in break mode Pressing 4Break5 aborts execution of this command 2 258 MPE iX Commands ...

Page 271: ...ed SHOWME programmatically or directly from the MPE iX command interpreter RELEASE Shows two version update level and x v uu numbers The rst v uu is the release number that shows the operating system release identi er This number is established by Hewlett Packard during their build of the entire software release package and provides an identity for the release The second v uu is the product number...

Page 272: ...adding the local CPU usage of the current process to the accumulated total of all terminated processes The CPU usage listed for a programmatic SHOWME therefore would rarely agree with that for a SHOWME entered in break mode CONNECT MINUTES Shows the amount of time in minutes the job or session has been connected STDIN LDEV Shows the logical device number of the job or session s standard input devi...

Page 273: ...icated by the system clock Syntax SHOWTIME Parameters None Operation Notes Usage You can enter this command from a session a job a program or in break mode Example To display the current date and time enter SHOWTIME MON MAY 6 1991 8 47 AM Related Commands None MPE iX Commands 2 261 ...

Page 274: ...es of a device class Start stop suspend and resume spooler printing processes Release les from the spooler process Syntax SPOOLER 2 DEV 3 8 ldev devclass devname 9 Plus one of the following options Status option 8 SHOW 9 Enable Disable option OPENQ SHUTQ 2 SHOW 3 Start option 8 START 9 OPENQ SHUTQ 2 SHOW 3 Stop option 8 STOP 9 FINISH NOW OPENQ SHUTQ 2 SHOW 3 2 262 MPE iX Commands ...

Page 275: ... letter and consist of eight or fewer alphanumeric characters devname Speci es the device name of the spooled device The devname must begin with a letter and consist of eight or fewer alphanumeric characters A device class name and a device name cannot be the same If you enter an alphanumeric character string the command searches the device class list rst then the device name list Status option SH...

Page 276: ...t specify either the OPENQ or SHUTQ option OPENQ is the default OPENQ For information about this parameter refer to OPENQ for the Enable Disable option SHUTQ For information about this parameter refer to SHUTQ for the Enable Disable option SHOW For information about this parameter refer to SHOW for the Status option Stop option STOP Terminates the spooling process associated with the speci ed devi...

Page 277: ...ts the spooler to immediately stop printing the currently active spool le This is the default for the STOP option OPENQ For information about this parameter refer to OPENQ for the Enable Disable option SHUTQ For information about this parameter refer to SHUTQ for the Enable Disable option SHOW For information about this parameter refer to SHOW for the Status option Suspend option SUSPEND Suspends ...

Page 278: ...nder the following conditions The spooler is actively processing a le or is suspending You do not specify the FINISH parameter NOKEEP Directs the spooler to close the spool le that it is currently processing This parameter is valid only under the following conditions The spooler is actively processing a le or is suspending You do not specify the FINISH parameter The spooler does the following when...

Page 279: ...tion SHUTQ For information about this parameter refer to SHUTQ for the Enable Disable option SHOW For information about this parameter refer to SHOW for the Status option Release option RELEASE Directs a suspended output spooler to close release a currently retained spool le The spool le was retained because you previously speci ed the SUSPEND KEEP parameters When the spooler releases the le the s...

Page 280: ...elective device errors This command a ects more than one process if applied to all devices in a class Consequently errors can occur for some of the devices but not others For example class LP consists of LDEVs 6 11 and 19 and a spooler process already owns LDEV 11 The command SPOOLER LP START would create and activate spooler processes for LDEVs 6 and 19 but would also generate the message DEVICE ...

Page 281: ...SPOOLER Related Commands LISTSPF OPENQ SHOWDEV SHUTQ SPOOLF MPE iX Commands 2 269 ...

Page 282: ...v devclass devname 9 3 5 2 PRI outpri 32 COPIES numcopies 3 2 SPSAVE 3 DEFER UNDEFER 2 SHOW 3 Print option SPOOLF 2 IDNAME 3 leset leset 2 leset 3 8 PRINT 9 2 4 DEV 8 ldev devclass devname 9 3 5 2 PRI outpri 32 COPIES numcopies 3 2 SPSAVE 3 DEFER UNDEFER 2 SHOW 3 Delete option SPOOLF 2 IDNAME 3 spoolid spoolid 2 spoolid 3 8 DELETE 92 SHOW 3 2 270 MPE iX Commands ...

Page 283: ...on as follows If you use DEFER or DEV for a spool le currently printing the spooler process interrupts the printing The spooler process saves the page number of the last complete page that was printed The next time any spooler selects the le for printing output resumes at the saved page number Because large amounts of data are bu ered in the le system and the device an output device may continue t...

Page 284: ...gin with a letter and consist of eight or fewer alphanumeric characters The system does not allow the same name to be con gured as a device class name and a device name The system interrupts spool le printing only if the newly speci ed target devclass di ers from the previous target devclass devname Speci es the device name of the spool le s new destination device If the spool le is in the print s...

Page 285: ...ver save private spool les When a le enters the SPSAVE state the system sets the priority to 8 and the number of copies to 1 DEFER Changes the spool le s state to DEFER If the spool le is currently in the print state its spooler is noti ed and printing stops The spool le s priority remains unchanged If you use this parameter with the PRINT option the system copies the spool le to OUT HPSPOOL and l...

Page 286: ...ct lockword for either mode the print option fails for the le and the command continues to process the remaining les PRINT Copies the speci ed le sets to the HPSPOOL account and links the new output spool les into the spool queues for printing This parameter is especially useful for generating additional copies of a spool le in the SPSAVE state You must have nonshareable device ND capability to us...

Page 287: ...ps at that point Because large amounts of data are bu ered in the le system and the device an output device may continue to print appearing as though the DELETE option has not a ected printing This is because the spooler stops sending data to the device when the command is received but must wait until all bu ered data has been printed before stopping Depending on both the content of the data and t...

Page 288: ...the DEV parameter Problem state spool les You can use the ALTER option on problem state spool les to alter the device attribute so that the spool le becomes ready again Generally the spool le is in the problem state because the target device of the spool le is invalid Example To change the priority of all output spool les to 8 and show the results enter SPOOLF O ALTER PRI 8 SHOW SPOOLID JOBNUM FIL...

Page 289: ...URGE 3 2 PROGRESS 2 minutes 3 3 2 DIRECTORY 3 2 TREE 32 NOTREE 3 Parameters lesetlist Speci es the set of les to be stored The default is all les in the current working directory regardless of capabilities The form of this parameter is as follows lesetitem lesetitem where lesetitem can be indirect le or leset indirect le A le name that backreferences a disk le The syntax is indirect le This le may...

Page 290: ...estostore lestoexclude Both lestostore and lestoexclude may be entered in MPE or HFS syntax Wildcards are permitted for both MPE as well as HFS syntax however MPE wildcards are not expanded in lestoexclude This means that is NOT an empty leset It would contain all of the HFS named les on the system The MPE syntax is as follows lename groupname accountname A lockword may be speci ed for les to be s...

Page 291: ...es one numeric character speci es one alphanumeric character These wildcard characters can be used as follows n Store all les starting with the character n n Store all les ending with the character n n Store all les starting with character n followed by up to seven digits useful for storing all EDIT 3000 temporary les n x Store all les starting with the character n and ending with the character x ...

Page 292: ...e may cause unpredictable results Since the hyphen is a valid character for HFS syntax le names it is allowed inside a character set immediately following a left bracket or preceding a right bracket When speci ed between two characters the hyphen implies a range of characters When a MPE name component is a single wildcard the will be folded to include all MPE and HFS named les at that level and be...

Page 293: ...s in the CWD All MPE and HFS les in the logon account All MPE named les in the system All the les and directories MPE and HFS in the system thisisit acct Any MPE le named thisisit in all the groups in one particular account store le The name of the device to which the stored les are to be written This may be any magnetic tape or DDS device This le must be backreferenced by using an asterisk You mu...

Page 294: ...f SYSLIST is less than 132 characters or LONG if SYSLIST is 132 or more characters If a HFS named le is speci ed in the lesetlist or the expansion of a wildcard includes a HFS named le then a HFS style output listing will be used This listing shows the same information as the MPE format but puts the name of the le at the right end of the listing to allow for longer HFS names If a HFS name is too l...

Page 295: ...d depending on whether the le has an ACD PATH Forces all le listings to be in HFS format The full HFS pathname is displayed instead of MPE style names OFFLINE Sends an additional copy to the format le designator OFFLINE which defaults to device LP ONERROR Tells STORE what to do if there is a tape write error If you omit this parameter then the default option is REDO ONERR is a synonym for ONERROR ...

Page 296: ...a log set PURGE Instructs MPE iX to purge all the les that were successfully stored after the STORE operation has ended In an interactive session MPE iX prompts the user to enter any lockwords that have been omitted if the user does not have system manager system supervisor or account manager capabilities In a job if the user does not have SM AM or OP capability the lockword s must be provided A l...

Page 297: ...s to dumping the system directory Otherwise the directories of the speci ed volume sets are dumped This way operators and manager can dump or copy private volume sets in their entirety TREE Forces each leset to be scanned recursively This is equivalent to using the trailing slash in an HFS name The TREE option yields a recursive scan in the hierarchical directory This option is mutually exclusive ...

Page 298: ...mmand with the RUN command for example RUN STORE PUB SYS The INFO parameter of the RUN command can be used to specify the STORE option lesets and keywords If no INFO parameters are speci ed the STORE prompt will appear Acceptable responses are a complete STORE command a complete RESTORE command or a complete VSTORE command If you have purchased a Turbostore product it will be installed as TSTORE P...

Page 299: ...nti ed as BACKUP A listing of the les stored appears on your standard list device To store all les on the system except the MPE les in the SYS account enter FILE TAP DEV TAPE STORE SYS TAP SHOW SECURITY DATES LONG OFFLINE The console operator receives a request to mount the tape identi ed as TAP A listing of the les stored appears on both standard list and at the system line printer The listing wi...

Page 300: ... les stored appears on your standard list device To store les from a group and account with a default store le enter STORE GROUP ACCOUNT or STORE Note that the console operator receives a request to mount the tape identi ed as the user s user name To store les from a group and account and to purge them after the STORE enter FILE T DEV TAPE STORE GROUP ACCOUNT PURGE Related Commands RESTORE VSTORE ...

Page 301: ...er of the rst record is assumed to be the replacement character for the expected colon that identi es commands You must have read R and lock L or execute X le access in order to specify this parameter char Identi es MPE iX commands within the input le It is a character that substitutes for a colon When you enter the input le on a device con gured to accept jobs or sessions this character can be an...

Page 302: ...deferred until the same day of the next month An error message is generated if the day of month does not correspond to the month for example if you enter 31 for February If you omit day of month the current date is used days until month Indicates days until the end of the month expressed using the negative integers 31 through 1 The chosen number speci es the calendar day from the end of the speci ...

Page 303: ...e current time expressed as a positive integer 0 minutes 59 If you omit this parameter zero is used Operation Notes Usage You can enter this command from a session a job a program or in break mode Pressing 4Break5 during an interactively streamed job aborts execution of the job Requirements You must have read R and lock L or execute X le access in order to stream jobs The system administrator shou...

Page 304: ...obs When you schedule a job for future execution it enters the SCHED state When the speci ed time arrives the job enters and remains in the WAIT state until the system allows the job to execute You can specify the time a job is to enter the WAIT state in absolute or relative time The di erences are as follows Absolute You specify an exact time for the job using the AT parameter with or without the...

Page 305: ...sting to appear on a device other than the standard listing device associated with the streaming device you can specify this other device using the JOB command as shown JOB USER TECHPUBS OUTCLASS 12 Terminating interactively streamed jobs To terminate interactive job input enter a colon The system responds by displaying the command interpreter prompt Denotes end of batch job input MPE iX prompts f...

Page 306: ... the current date and time are Monday June 10 1991 at 12 00 pm The examples also assume that the input le named JOBFILE contains a valid STREAM job To introduce JOBFILE immediately enter STREAM JOBFILE To introduce JOBFILE at 8 00 am Tuesday June 11 enter STREAM JOBFILE AT 8 00 To introduce JOBFILE at 8 00 pm Monday June 10 enter STREAM JOBFILE AT 20 00 To introduce JOBFILE in eight hours at 8 00 ...

Page 307: ...troduced on Wednesday July 31 at 12 00 pm If July 31 did not exist this command would cause an error STREAM JOBFILE DAY 2 The 2 means the second to last day of the month and since no time was speci ed the current time is used JOBFILE will be introduced on Sunday June 30 at 12 00 pm STREAM JOBFILE DAY 25 The 25 means the twenty fth day from the end of the month If one assumes the current month that...

Page 308: ...STREAM Related Commands ABORTJOB JOB LISTSPF SHOWJOB STREAMS 2 296 MPE iX Commands ...

Page 309: ...mber or class that references logical devices of type 32 You can use any input device except the console or terminals The input device must be con gured in the SYSGEN dialog as capable of accepting jobs OFF Disables the streams facility Operation Notes Usage You can enter this command from a session a job a program or in break mode Pressing 4Break5 does not a ect this command You can enter this co...

Page 310: ...lity is disabled the following message appears STREAM FACILITY NOT ENABLED SEE OPERATOR CIERR 82 Selecting the streams device The streams device is normally LDEV 10 Your system administrator knows the LDEV for the streams device Examples To enable jobs and data streams on logical device number 10 enter STREAMS 10 To disable data streams enter STREAMS OFF Related Commands ALLOW STREAM 2 298 MPE iX ...

Page 311: ...bring up the system which is normally CONFIG newgroup Speci es the name of a group in the SYS account used as the default for keeping a new set of con guration data or a copy of the con guration data in the base con guration group If you do not include this parameter the default is the basegroup input Speci es the le designator of the le to be used for command input while the SYSGEN command is exe...

Page 312: ... user response to the tape request necessary for the backup In order to perform an unattended backup however the tape drive must be con gured with the autoreply mode Refer to the Examples section for the proper command sequence to enable this mode Examples To use CONFIG SYS as the default basegroup NEWCONF SYS as the newgroup and the default input le and output le enter SYSGEN CONFIG NEWCONF STDIN...

Page 313: ...SYSGEN To con gure a tape drive for autoreply mode enter SYSGEN SYSGEN IO IO MDEV 7 MODE AUTOREPLY IO HOLD IO EXIT SYSGEN KEEP SYSGEN EXIT Related Commands NMMGR SHOWDEV VOLUTIL MPE iX Commands 2 301 ...

Page 314: ...e session or user to receive the message and the account name to which the message is directed This parameter is the same as the session identity entered with the HELLO command Speci es all sessions acctname Speci es all user names logged on to the account name text Speci es message text preceded by a space or a semicolon that consists of a string of any ASCII characters If you do not provide mess...

Page 315: ...l characters that invoke bells or inverse video Restrictions You cannot send a message to a job or to yourself If you attempt to send a message to a job the following warning appears TARGET MUST BE INTERACTIVE NO MESSAGE SENT CIWARN 1627 If you send a message to a terminal currently interacting with a program the system queues the message as high as possible among the current input output requests...

Page 316: ...TELL Related Commands SETMSG TELLOP WARN 2 304 MPE iX Commands ...

Page 317: ...d Operation Notes Usage You can enter this command from a session a job a program or in break mode Pressing 4Break5 does not a ect this command Command processing You can send a message to the console even if a session is not currently active or if an active session is running in quiet mode As with messages transmitted with the TELL command a message sent using the TELLOP command prints as soon as...

Page 318: ...TELLOP Related Commands TELL WARN 2 306 MPE iX Commands ...

Page 319: ...a session number assigned by the system for the job that is to receive the message Only jobs submitted on interactive devices can receive messages jsname user acct Speci es the names of the job session and user to receive the message and speci es the account name under which they are running These names are the same as those entered with the JOB or HELLO command If several users are running under ...

Page 320: ...d the ALLOW command to enable you to enter the WARN command Quiet mode A user can run a session in quiet mode which suppresses messages from other users however the WARN command overrides quiet mode and also overrides a block mode screen Example To send a WARN message to all sessions followed by a WARN message to session S51 enter WARN THE SYSTEM WILL SHUTDOWN IN 5 MINUTES PLS LOG OFF WARN S51 LAS...

Page 321: ... and leaves the welcome message unchanged You can only enter this command from the console however you can enter this command from your terminal if your system administrator has used the ALLOW command to enable you to enter the WELCOME command You do not have to reboot the system after entering this command Creating and deleting messages You can either create a message interactively or specify a p...

Page 322: ...ter WELCOME WELCOME TO THE HP 3000 COMPUTER SYSTEM FILES WILL BE STORED EACH DAY BETWEEN 6AM AND 7AM 4Return5 To use a prede ned message le called MESSAGE1 enter WELCOME MESSAGE1 To delete MESSAGE1 enter WELCOME 4Return5 Related Commands HELLO SHOWME 2 310 MPE iX Commands ...

Page 323: ... 8 parmvalue 9 3 Parameters lename Speci es the le name of the command le or program le to be executed The system uses the search path HPPATH if you do not qualify lename parameterlist Lists the parameters passed to lename when a command le executes The parameter list corresponds to the PARM line s of the command le you want to execute INFO Speci es a parameter string quotedstring for program les ...

Page 324: ... use the NOBREAK option You can execute many command les in break mode however if a command le runs a program the system prompts you to abort the suspended program You cannot execute program les in break mode unless you abort the suspended program Example To execute a command le named FCOPY PUB MYACCT enter XEQ FCOPY PUB MYACCT Related Commands ABORT RESUME RUN 2 312 MPE iX Commands ...

Page 325: ...command 2 6 allowable commands 2 8 examples 2 9 modes 2 7 requirements 2 7 ALTACCT command 2 11 activation 2 14 examples 2 14 restrictions 2 14 altering program les 2 68 spool les 2 270 text les 2 68 ALTGROUP command 2 19 examples 2 22 ALTSEC command 2 33 ALTUSER command 2 34 examples 2 37 assigning job numbers 2 100 attributes les 2 76 B backing up the system 2 277 backreferencing 2 77 batch jobs...

Page 326: ...tions 1 2 PURGEDIR 2 186 command stream inserting comments 2 48 COMMENT command 2 48 adding comments lines 2 48 example 2 48 comments inserting 2 48 console changing to another terminal 2 50 displaying logical device number 2 50 displaying pending messages 2 200 moving 2 50 CONSOLE command 2 50 examples 2 51 restrictions 2 50 console commands versus operator commands 2 8 CONTINUE command 2 52 exam...

Page 327: ... 2 261 directory information 2 57 2 112 directory space 2 59 disk space 2 59 le information 2 112 group information 2 135 information for all input and output devices 2 247 jobfence job session limits 2 251 jobs and sessions status 2 251 2 258 pending console messages 2 200 resource limits 2 209 status of spooling process 2 262 total resource usage 2 209 user information 2 148 E EDITOR command 2 6...

Page 328: ... and restrictions 2 85 examples 2 86 passwords 2 85 providing a group name 2 84 help getting online information 2 87 information access methods 2 89 HELP command 2 87 examples 2 90 Help Facility 2 87 I input devices displaying status information 2 247 input priority jobs 2 99 interactively streamed jobs terminating 2 293 J job and session limits rede ning 2 106 JOB command 2 96 command process 2 1...

Page 329: ... 138 examples 2 144 format description 2 139 2 141 LISTUSER command 2 148 examples 2 149 restrictions 2 149 logging o 2 40 logging on 2 82 access permissions 2 85 jobs 2 96 logical device numbers displaying 2 258 logon groups 2 84 M magnetic tape restoring les from 2 213 storing les on 2 277 messages control maintenance processor 2 51 creating welcome messages 2 309 diagnostic control unit 2 51 di...

Page 330: ...nding resource requests replying to 2 206 permission to enter commands ALLOW command 2 6 prepared programs executing 2 231 PRINT command 2 178 batch print jobs 2 179 examples 2 179 printing altering spool le print priorities 2 174 control spooler printing processes 2 262 les 2 178 redirecting output 2 178 spool les 2 270 priority of jobs 2 103 of spool le printing 2 173 queues jobs 2 99 program le...

Page 331: ...ty provisions 2 202 RENAME command 2 204 examples 2 205 renaming spool les 2 205 requirements 2 204 restrictions 2 205 REPLY command 2 206 examples 2 207 replying to requests 2 207 requirements 2 207 replying to resource requests 2 206 REPORT command 2 209 example 2 212 requirements 2 211 resource limits displaying 2 209 resources displaying 2 209 replying to pending requests 2 206 RESTORE command...

Page 332: ...e 2 261 SPOOLER command 2 262 enable disable option 2 264 example 2 268 release option 2 267 resume option 2 267 selective device errors 2 268 start option 2 264 status option 2 263 stop option 2 264 suspend option 2 265 SPOOLF command 2 270 altering private spool les 2 276 alter option 2 271 delete option 2 275 example 2 276 print option 2 274 problem state spool les 2 276 spool les altering 2 27...

Page 333: ...ystem administrator tasks ALLOW command 2 6 ALTACCT command 2 11 NEWACCT command 2 150 NEWUSER command 2 170 PURGEACCT command 2 184 PURGEGROUP command 2 194 PURGEUSER command 2 198 system de ned les 2 77 T TELL command 2 302 examples 2 303 multiple users 2 303 quiet mode 2 303 restrictions 2 303 TELLOP command 2 305 command processing 2 305 example 2 305 terminating batch jobs 2 71 interactively ...

Page 334: ... mode 2 308 WELCOME command 2 309 creating and deleting messages 2 309 examples 2 310 welcome messages creating 2 309 wildcard characters 2 109 2 135 wildcards delete using 2 193 REPORT command 2 210 X XEQ command 2 311 example 2 312 Index 10 ...

Search results

Summary of Contents for e3000

Reviews:

Related manuals for e3000

Brands by name

Popular brands

HP e3000, Command Reference Manual

Search results

Summary of Contents for e3000

Reviews:

Related manuals for e3000

Brands by name

Popular brands