HP (Hewlett-Packard) HP 3000 manuale d’uso

MPE/iX Commands Reference Manual HP 3000 MPE/iX Computer Systems Edition 10 32650-90864 E1098 Printed in: U .S .A. October 1998[...]

Notice The information contained in this document is subject to change without notice. Hewlett-P ackard makes no w arranty of any kind with regard to this material, including , but not limited to, the implied w arranties of merchantability or fitness for a particular purpose . Hewlett-P ackard shall not be liable for errors contained herein or for[...]

3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 1. Commands by T ask T ask-Related Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 4 2. Command Definitions A-B Commands and[...]

4 COB74XLK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .146 COB85XL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .149 COB85XLG . . . . . . . . . . . . . . . . . . . . . . . . . . . . [...]

5 FREERIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261 FTN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262 FTNGO . . . . . . . . . . . . . . . . . . . . . . . . . . [...]

6 6. Command Definitions P-R P ASCAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .414 P ASCALGO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .416 P ASCALPREP . . . . . . . . . . . [...]

7 SET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 542 SETCA TALOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 544 SETCLOCK . . . . . . . . . . . . . . . . . . . . . . . . . . .[...]

8 VSRESERVESYS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .700 VSTORE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .701 VSUSER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .[...]

9 Restricted Rights Legend 2 T able 2-1. Parm= values for the CI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 T able 2-2. Default Parameters for the AL TACCT Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 T able 2-3. Default V alues for the AL TGROUP Command . . .[...]

10[...]

11 Preface The ninth edition of the MPE/iX Commands Reference Manual is one volume with command descriptions alphabetically from A through X. This manual is written for all users of the HP 3000 MPE/iX Computers . MPE/iX, Multiprogramming Executive with Integrated POSIX, is the latest in a series of forward-compatible operating systems for the HP 30[...]

12 COMMAND {ON | OFF} [ ] In a syntax statement, brackets enclose optional elements . In the following example, OPTION can be omitted: COMMAND filename [OPTION] When several elements are enclosed within brackets , you canm select one or none of the elements . In following example, you can select OPTION or parameter or neither . The elements cannot[...]

Chapter 1 13 Commands by T ask 1 Commands by T ask Commands are used to communicate with the MPE/iX operating system. They request MPE/iX to perform a specific task or provide specific information.[...]

14 Chapter 1 Commands by T ask T ask-Related Commands T ask-Related Commands This chapter is an introduction to MPE/iX commands and their functions , categorized by the task they perform. The categories of tasks identified for MPE/iX commands are: • Accessing Subsystems and Utilities . • Command Interpreter Programming T ools. • Communicatin[...]

Chapter 1 15 Commands by T ask T ask-Related Commands Check that list to find an appropriate functional description, which in this case is "Creates a new account". Then check the lefthand column for the name of the command that performs that function, which in this case is NEWACCT . When you have located the command that most closely per[...]

16 Chapter 1 Commands by T ask T ask-Related Commands RETURN Causes execution to return from the current user command (UDC or command file) to the calling environment SETVAR Creates or modifies a CI variable. WHILE Used to control execution in a job, session, UDC , or command file. Communicating with Other Users TELL Sends a message to another a[...]

Chapter 1 17 Commands by T ask T ask-Related Commands PURGEUSER Removes a user from an account. REPORT Displays accounting information about the logon account and group . Managing Devices ABORTIO =ABORTIO Aborts a single pending I/O request for a device. ASSOCIATE Gives a user operator control of a device. DEVCNTRL Script that ejects a tape an/or s[...]

18 Chapter 1 Commands by T ask T ask-Related Commands LISTFILE Lists file information using native mode scanning/parsing that can be easily expanded. LISTFTEMP Displays information about temporary files . NEWDIR Creates a directory NEWLINK Creates a symbolic link PRINT Prints the contents of a file. PURGE Deletes a file from the system. PURGEDI[...]

Chapter 1 19 Commands by T ask T ask-Related Commands HELLO Initiates an interactive session. JOB Defines a job to be activated in conjunction with the STREAM command to run in batch mode . JOBFENCE Defines the minimum input priority a job or session must have in order to execute. JOBPRI Sets or changes the default and/or maximum execution priori[...]

20 Chapter 1 Commands by T ask T ask-Related Commands OUTFENCE Defines the minimum priority an output spoolfile needs in order to be printed. RESUMESPOOL Resumes suspended spooler output to a spooled device. STARTSPOOL Initiates the spooler process for a device. SHUTQ Closes the spool queue for a specified logical device or device class . SPOOLE[...]

Chapter 1 21 Commands by T ask T ask-Related Commands SHOWQ Displays process scheduling data and the contents of eac h subqueue. =SHUTDOWN Initiates a shutdown of MPE/iX. TUNE Alters the dispatcher subqueues which determine when processes must relinquish the CPU . Managing User/System Logging ALTLOG Alters the attributes of an existing user logging[...]

22 Chapter 1 Commands by T ask T ask-Related Commands LDISMOUNT Causes a volume set that was reserved system-wide by the user to be released. LMOUNT Reserves a volume set system-wide. MOUNT Reserves an online volume set. VMOUNT Enables/disables the MPE/iX movable volume facility . VOLTIL Defragment diskspace, general user volume management VSCLOSE [...]

Chapter 1 23 Commands by T ask T ask-Related Commands BBASICOMP Compiles an HP Business BASIC/V program in compatibility mode . BBASICPREP Compiles and prepares an HP Business BASIC/V program in compatibility mode. BBXL Initiates execution of the HP Business BASIC/XL interpreter . BBXLCOMP Compiles an HP Business BASIC/XL program. BBXLGO Compiles ,[...]

24 Chapter 1 Commands by T ask T ask-Related Commands FTNXL Compiles an HP FORTRAN 77/iX program. FTNXLGO Compiles , links, and executes an HP FORTRAN 77/iX program. FTNXLLK Compiles and links an HP FORTRAN 77/iX program. PASCAL Compiles a compatibility mode P ascal/V program. PASCALGO Compiles , prepares, and executes a compatibility mode P ascal/[...]

Chapter 2 25 Command Definitions A-B 2 Command Definitions A-B This chapter provides information on MPE/iX commands . F or your convenience, they are arranged in alphabetical order . Each command specification contains the following information: Command Name Provides the command name at the top of each page followed by a brief definition of its[...]

26 Chapter 2 Command Definitions A-B[...]

Chapter 2 27 Command Definitions A-B Commands and Parameter s Commands and P arameters MPE/iX commands tell the computer to perform a specific function. The parameters you enter for each command tell the computer to perform the function in a specific w ay . MPE/iX uses four classifications of parameters: • Required parameters . • Optional p[...]

28 Chapter 2 Command Definitions A-B Commands and Parameter s P ositional P arameters The meaning of a positional parameter depends upon its position (location) in the parameter list. In the syntax diagrams for each command in this chapter , positional parameters are separated from each other by a comma ( , ). If you omit a positional parameter fr[...]

Chapter 2 29 Command Definitions A-B Commands and Parameter s[...]

30 Chapter 2 Command Definitions A-B Native Mode Command Structure Native Mode Command Structure Many commands in this chapter have the designation Native Mode at the end of their definition. This means that the command is parsed by the Native Mode Command P arser . If Native Mode is not specified, the command is parsed by the Compatibility Mode[...]

Chapter 2 31 Command Definitions A-B Native Mode Command Structure Combining P ositional/Keyword P arameters Another option is to enter NM-parsed commands by using a combination of positional and keyword specifications , for example: COMMAND A,B;KEYWORD3=C There is one important rule to remember when you combine positional and keyword parameters:[...]

32 Chapter 2 Command Definitions A-B Native Mode Command Structure Or , because decimal is the default you could omit the # sign and enter: SPOOLER DEV=0006;SUSPEND;SHOW Or , omitting the leading zeroes you could enter: SPOOLER DEV=6;SUSPEND;SHOW When entering numbers as command parameters , it is advisable to omit leading zeros for some commands [...]

Chapter 2 33 Command Definitions A-B Native Mode Command Structure String Processing MPE/iX string pr ocessing finds the first double or single quote and pairs it with the last quote of the same type to form a string. In other words , single quotes pair only with other single quotes and double quotes only with other double quotes . F or this rea[...]

34 Chapter 2 Command Definitions A-B Native Mode Command Structure • The SETVAR command. • The XEQ command. These three exceptions allow the use of only specific delimiters when specifying parameters , as defined below . Also the ECHO command accepts all delimiters and treats them as part of the value to be echoed Invoking User Defined Comm[...]

Chapter 2 35 Command Definitions A-B Native Mode Command Structure NO TE If a parameter value begins with a quote it must have a matching end quote . If it does not begin with a quote it may contain embedded quotes which will be treated as any other character . F or more information on the use of quotes, refer to the section "Using Quotes and[...]

36 Chapter 2 Command Definitions A-B Remote Sessions and Command Intrinsics Remote Sessions and Command Intrinsics When used to invoke commands on remote systems the COMMAND or HPCICOMMAND intrinsics do not return a meaningful status code. F or more information on calling intrinsics refer to the MPE/iX Intrinsics Reference Manual.[...]

Chapter 2 37 Command Definitions A-B Running the CI as a Program Running the CI as a Program The MPE/iX Command Interpreter (CI) is a Native Mode Program. Y ou can run it the wa y you would any other program, either by explicitly using the RUN command (the first example below), or by using the the implied RUN (the second example): RUN CI.PUB.SYS [...]

38 Chapter 2 Command Definitions A-B ABORT ABORT Aborts the current program or operation suspended by BREAK. (Native Mode) Syntax ABORT P arameters None. Operation Notes The ABORT command terminates a process that has been suspended by pressing the Break key . Programs do not terminate while critical system code is executing on their behalf , but [...]

Chapter 2 39 Command Definitions A-B ABORTIO/ =ABOR TIO ABORTIO/ =ABORTIO Aborts a single pending I/O request for a device. Syntax ABORTIO ldev =ABORTIO ldev P arameters ldev The logical device number of the device for which you intend to abort one pending I/O request. Operation Notes This command aborts a single pending I/O request for the speci?[...]

40 Chapter 2 Command Definitions A-B ABORTIO/ =ABOR TIO Examples T o abort a pending I/O request for logical device 53, enter: ABORTIO 53 It is necessary to issue several ABORTIO commands to abort all pending I/O operations on a spooled device, as shown below: STOPSPOOL 5 11:20/31/SP#5/STOPPED 11:20/31/LDEV#5 NOT READY REFUSE 5 ABORTIO 5 ABORTIO 5[...]

Chapter 2 41 Command Definitions A-B ABORTJOB/ =ABOR TJOB ABORTJOB/ =ABORTJOB Aborts a job or session. Syntax ABORTJOB {# J nnn #S nnn [ jobname ,] user . acct } =ABORTJOB {# J nnn #S nnn [ jobname ,] user . acct } P arameters #J nnn A job number . #S nnn A session number . jobname The name of the job, as identified by the SHOWJOB command. user A[...]

42 Chapter 2 Command Definitions A-B ABORTJOB/ =ABOR TJOB The standard error message that appears when a request is manually terminated by entering Y in response to =REPLY (or REPLY ) is displayed on the user's terminal: SESSION ABORTED BY SYSTEM MANAGEMENT The =ABORTJOB command may be used at the physical console if ABORTJOB is ineffective. [...]

Chapter 2 43 Command Definitions A-B A CCEPT ACCEPT P ermits a designated device to accept jobs/sessions and/or data. Syntax ACCEPT [ JOBS | DAT A ] ,lde v P arameters JOBS The designated device recognizes the JOB and HELLO commands. The device must be interactive to support sessions . DATA The designated device recognizes the DATA command. Data-a[...]

44 Chapter 2 Command Definitions A-B A CCEPT Examples T o permit logical device 19 to accept jobs and data, enter: ACCEPT 19 SHOWDEV 19 LDEV AVAIL OWNERSHIP VOLID ASSOCIATION 19 AVAIL T o permit logical device 19 to accept jobs and data, and to allow the device to be spooled, enter: ACCEPT 19 STARTSPOOL 19 11:12/31/SP#/SPOOLED IN 11:12/6/LDEV#19 N[...]

Chapter 2 45 Command Definitions A-B ALLOCA TE ALLOCA TE Loads a compatibility mode program or procedure into virtual memory . Syntax ALLOCATE [ PROCEDURE, | PROGRAM, ] name P arameters PROCEDURE The procedure in SL.PUB.SYS to be allocated. The default is PROGRAM . PROGRAM The program file to be allocated. Default. name The name of the program ?[...]

46 Chapter 2 Command Definitions A-B ALLOCA TE In addition to comma (,) a semicolon (;) and equal sign (=) may be used as a delimiter . Example T o allocate a procedure identified as PROC1 , that resides in SL.PUB.SYS , enter: ALLOCATE PROCEDURE,PROC1 Program files residing in the nonsystem domain (a volume set) are not allocated. Attempts to do[...]

Chapter 2 47 Command Definitions A-B ALLO W ALLOW Grants a user access to a specific operator command. Syntax ALLOW FILE= formaldesignator [ ;SHOW] ALLOW[ @.@ | user .@ | @.acct | user .acct ;COMMANDS= command [ , command ,...] P arameters formal- designator An ASCII file name, which ma y consist of one to eight alphanumeric characters , beginni[...]

48 Chapter 2 Command Definitions A-B ALLO W 2 JOHN.ACCTNG;COMMANDS=ALTJOB,DELETESPOOLFILE 3 // ... / KEEP ALLOWTMP / E Once you create an indirect file, you then issue the ALLOW command, using the ;SHOW parameter to display each command line as it is executed from the file . F or example: ALLOW FILE=ALLOWTMP;SHOW Y ou may backreference the file[...]

Chapter 2 49 Command Definitions A-B ALLO W CONSOLE MRJECONTROL VMOUNT DELETESPOOLFILE OPENQ VSCLOSE DISALLOW OUTFENCE VSOPEN DISCRPS REFUSE VSRELEASESYS DOWN REPLY VSRESERVESYS DOWNLOAD RESUMEJOB WARN HEADOFF SPOOLER WELCOME Use Y ou may issue this command from a session, job , program, or in BREAK. Pressing Break will terminate subsystem mode an[...]

50 Chapter 2 Command Definitions A-B AL T A CCT AL T ACCT Changes the attributes of an existing account. Syntax ALTACCT acctname [ ;PASS=[ passwor d ] ] [ ;FILES=[ filespace ]] [ ;CPU=[ cpu ]] [ ;CONNECT=[ connect ] ] [ ;CAP=[ capabilitylist ] ] [ ;ACCESS=[ ( fileaccess )]] [ ;MAXPRI=[ subqueuename ] ] [ ;LOCATTR=[ localattribute ] ] [ ;ONVS= vo[...]

Chapter 2 51 Command Definitions A-B AL T A CCT If a capability is removed at the account level, users within the account are also denied that capability . No explicit change to the user's capabilities is necessary . Similarly , if a capability is returned to the account, any users with that capability regain it automatically . Each capabilit[...]

52 Chapter 2 Command Definitions A-B AL T A CCT subqueuename Name of the highest priority subqueue that can be requested by any process of any job/session in the account, specified as AS , BS , CS , DS , or ES . When you specify ;MAXPRI= without a value, subqueuename defaults to CS . CA UTION User processes executing in the AS or BS subqueues can[...]

Chapter 2 53 Command Definitions A-B AL T A CCT T able 2-2 Default P arameters for the AL T ACCT Command Any value changed with the ALTACCT command takes effect the next time MPE/iX is requested to check the value . If an attribute is removed from an account while users are logged on, they are not affected until they log off their current job or s[...]

54 Chapter 2 Command Definitions A-B AL T A CCT T o c hange the password and the file space of an account called MALCHIOR in the volume set TIME_LORD , you need to issue two commands: ALTACCT MALCHIOR;PASS=OMSBOROS ALTACCT MALCHIOR;ONVS=TIME_LORD;FILES=20000 Y ou must specify the changes for the system volume set (the first command) and for the [...]

Chapter 2 55 Command Definitions A-B AL TFILE AL TFILE Changes the attributes of an existing file or directory . (Native Mode) Syntax ALTFILE[ FILE=] filename [ ] ;OWNER= ownername ] ] [ [ ;GROUPID=] POSIXgr oupname ] P arameters filename The filename of the object to be altered, specified in either MPE or HFS syntax. The filename may name a[...]

56 Chapter 2 Command Definitions A-B AL TFILE In order to change the GID of a file , you must be one of the following: • The file owner (your logon name matches the UID of the file). In this case , POSIXgr oupname must specify your logon account. • The file's account manager (your logon account matches the GID of the file and you hav[...]

Chapter 2 57 Command Definitions A-B AL TGROUP AL TGROUP Changes one or more attributes of a group. Syntax ALTGROUP gr oupname [ . acctname ] [ ;PASS=[ passwor d ]] [ ;CAP=[ capabilitylist ] ] [ ;FILES=[ filespace ] ] [ ;CPU=[ cpu ] ] [ ;CONNECT=[ connect ] ] [ ;ACCESS=[ ( fileaccess )] ] [ ;ONVS= volumesetname ] [ ;HOMEVS= volumesetname ] P ara[...]

58 Chapter 2 Command Definitions A-B AL TGROUP Each capability is denoted by a two letter mnemonic , as follows: Process Handling = PH Extra Data Segments = DS Multiple RINs = MR Privileged Mode = PM Interactive Access = IA Batch Access = BA Default is IA, BA except for the PUB group of the SYS account which has no true default. It is assigned the[...]

Chapter 2 59 Command Definitions A-B AL TGROUP The user types are specified 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 T o specify two or more user or access types, separate them by commas . ONVS A particular volume set for which the gr[...]

60 Chapter 2 Command Definitions A-B AL TGROUP unchanged. When a keyword is included but the corresponding parameter is omitted (as in PASS = Return ), the default value is assigned. T able 2-3 lists the default values for the ALTGROUP command. T able 2-3 shows the default values for the AL TGROUP Command. T able 2-3 Default V alues for the AL TGR[...]

Chapter 2 61 Command Definitions A-B AL TGROUP However , if LEILA does contain files, you cannot c hange the home volume set for this group without creating a new group and transferring those files to it. Related Information Commands ALTACCT , ALTUSER Manuals V olume Management Reference Manual[...]

62 Chapter 2 Command Definitions A-B AL TJOB AL TJOB Alters the attributes of waiting or sc heduled jobs. (Native Mode) Syntax ALTJOB[ JOB=] { #Jnnn #Snnn } [ ;INPRI= inputpriority ] [ ;OUTDEV={ l dev de vclass } ] [.HIPRI][;JOBQ=queuename] P arameters #J nnn A job number . #S nnn A session number . (Although syntactically correct, this parameter [...]

Chapter 2 63 Command Definitions A-B AL TJOB JOBFENCE 14 15:11/#J1/24/DEFERRED JOB INTRODUCED ON LDEV #53 15:11/#J2/25/DEFERRED JOB INTRODUCED ON LDEV #53 15:13/#J3/26/DEFERRED JOB INTRODUCED ON LDEV #53 SHOWJOB JOBNUM STATE IPRI JIN JLIST INTRODUCED JOB NAME #S23 EXEC 20 20 THU 2:15P OPERATOR.SYS #J1 WAIT D 8 10S 12 THU 3:11P JOB2,OP.SYS #J2 WAIT[...]

64 Chapter 2 Command Definitions A-B AL TLOG AL TLOG Alters the attributes of an existing user logging identifier . Syntax ALTLOG logid [ ;LOG= logfile { ,DISC ,TAPE } ] [ ;PASS= passwor d [ { ;AUTO ;NOAUTO } ] P arameters logid The logging identifier whose attributes are to be changed. This identifier must contain from one to eight alphanumer[...]

Chapter 2 65 Command Definitions A-B AL TLOG Use This command may be issued from a session, job , program, or in BREAK. Pressing Break has no effect on this command. User logging (LG) capability is required to use this command. Example T o change the destination log file of the logging identifier KIM to log file C and specify that C resides on [...]

66 Chapter 2 Command Definitions A-B AL TPROC AL TPROC Changes characteristics of the specified processes . Currently , a process' priority , queue attribute, and workgroup ma y be changed. (Native Mode) Syntax ALTPROC[ [ PIN=] { pinspec ( pinspec [ ,pinspec ] ...) } [ ;JOB=] { jobspec ( jobspec [ ,jobspec ] ...) } ] [ [ ;PRI=] pri [ ;WG= ] [...]

Chapter 2 67 Command Definitions A-B AL TPROC However , if you add anyuser to the same command as shown below , then all job processes are altered. :ALTPROC job=@j;pri=cs;anyuser TREE is the default for all jobspec target processes, and can be overridden with the NOTREE option. The SYSTEM option is ignored for all jobspec target processes. The job[...]

68 Chapter 2 Command Definitions A-B AL TPROC priority specified need not fall between the base and limit priorities of the workgroup. T o assign an absolute priority value , you must have SM capability . If you do not have SM capability , then your MAXPRI value represents the highest priority that you can assign a process . A warning appears whe[...]

Chapter 2 69 Command Definitions A-B AL TPROC Operation Notes T o execute the ALTPROC command, you must have System Supervisor (OP) or System Manager (SM) capability . SM capability is necessary to alter system processes, for the WG= option, for certain specifications to the PRI option, and to increase a process' priority above MAXPRI . Y ou[...]

70 Chapter 2 Command Definitions A-B AL TSEC AL TSEC Changes the access permissions of an object by altering the access control definition (ACD). ACDs are the main method of controlling access to files , hierarchical directories, and devices . ACDs are automatically assigned to hierarchical directories and to files existing in hierarchical dire[...]

Chapter 2 71 Command Definitions A-B AL TSEC MPE Syntax Y ou can include MPE file name Syntax but not RF A information. If the object is an MPE Syntax file, its format is: filename [/ lockwor d ][. groupname [. acctname ]] Y ou may specify file lockwords for files protected by active loc kwords unless the objects are also protected by a curre[...]

72 Chapter 2 Command Definitions A-B AL TSEC Y ou 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 specification of fileaccess . NEWACD Creates a new ACD for the specified object. NEWACD is u[...]

Chapter 2 73 Command Definitions A-B AL TSEC Y ou cannot use wildcards in any other manner within a user specification. A typical ACD consisting of three ACD pairs might look like this: (R,W:ENGR.MFG;R,W,RACD:@.MRKT;R:@.@) This ACD would allow Read and Write access to the ENGR user of the MFG account; Read and Write access to any user of the MRKT[...]

74 Chapter 2 Command Definitions A-B AL TSEC Operation Notes Y ou use the ALTSEC command to alter security provisions for files, hierarchical directories , devices , and device classes by manipulating an object's access control definition (ACD) or its access mask. All of these objects may have ACDs , but only files have access masks which [...]

Chapter 2 75 Command Definitions A-B AL TSEC ALTSEC FPROG;ACCESS=(X:GU;R,W:AL,GL) ACD Examples T o view ACD information, use the LISTFILE,-2 command. This form of the LISTFILE command displays only ACD information. Y ou have created a file named FDATA , and want to assign a new ACD to FDATA , granting write access to a user named FRIEND.ACCT . En[...]

76 Chapter 2 Command Definitions A-B AL TSEC Note that L and A (lock and append) need not be specified because they are implied with W (write). T o add an ACD that prevents any user except OPERATOR.SYS (and any user with SM capability) from accessing LDEV 7 (a tape drive), enter: ALTSEC 7,LDEV;NEWACD=(R,W:OPERATOR.SYS) Note in the last example th[...]

Chapter 2 77 Command Definitions A-B AL TSPOOLFILE AL TSPOOLFILE Alters the characteristics of an output spoolfile . Syntax ALTSPOOLFILE{ #Onnn ldev1 } { ;PRI= outputpriority ;COPIES= numcopies ;DEV={ lde v2 devclass } ;DEFER } [ ;...] P arameters #O nnn The output device file identification of a spoolfile. ldev1 The logical device number of t[...]

78 Chapter 2 Command Definitions A-B AL TSPOOLFILE Y ou may alter the outputpriority or the numcopies of an ACTIVE spoolfile without interrupting the printing process . If you alter the device or defer the ACTIVE spoolfile with the DEFER parameter , the printer stops immediately . In both cases , the entire file is printed when printing resumes[...]

Chapter 2 79 Command Definitions A-B AL TUSER AL TUSER Changes the attributes currently defined for a user . Syntax ALTUSER username [ .acctname ] [ ;PASS=[ passwor d ] ] [ ;CAP=[ capabilitylist] ] [ ; MAXPRI=[ subsueuename ] ] [ ;LOCATTR=[ localattribut ] ] [ ;HOME=[ home gr oupname ] ] [ ;UID=[ uid ] [ ;USERPASS=[ r eq opt ] [ Expir ed ] ] The [...]

80 Chapter 2 Command Definitions A-B AL TUSER Save Files = SF Access to Nonshareable I/O Devices = ND Use Volumes = UV Create Volumes = CV Use Communication Subsystem CS Programmatic Sessions = PS User Logging = LG Process Handling = PH Extra Data Segments = DS Multiple RINs = MR Privileged Mode = PM Interactive Access = IA Batch Access = BA Progr[...]

Chapter 2 81 Command Definitions A-B AL TUSER Opt USERP ASS=OPT specifies that users in this account may or may not have passwords . If you do not use the USERP ASS parameter , the old value remains . It is a vailable only if the HP Security Monitor has been installed. Expir ed The password expires immediately . The user cannot logon without sele[...]

82 Chapter 2 Command Definitions A-B AL TUSER Use This command may be issued from a session, a job , a program, or in break mode. Pressing Break has no effect on this command. Account manager (AM) capability is required to use this command. System manager (SM) capability is required to specify a user in an account other than your own. Examples Sup[...]

Chapter 2 83 Command Definitions A-B ASSOCIA TE ASSOCIA TE Gives a user operator control of a device class . Syntax ASSOCIATE devclass P arameters devclass The name of a logical device class configured with SYSGEN . Operation Notes This command links a device class , such as LP , to an individual user on the system. The user may then execute any [...]

84 Chapter 2 Command Definitions A-B ASSOCIA TE ASSOCIATE TAPE Related Information Commands DISASSOCIATE Manuals P erforming System Operation T asks[...]

Chapter 2 85 Command Definitions A-B BASIC BASIC Interprets a compatibility mode BASIC/V program. B ASIC/V is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purc hased separately . Syntax BASIC[ commandfile ] [ ,[ inputfile ] [ , listfile ] ] P arameters commandfile Actual file designator of the [...]

86 Chapter 2 Command Definitions A-B BASIC Examples T o enter commands and data from your standard input device, with program listing and output transmitted to the standard output device, enter: BASIC Y ou may also submit commands and data to the B ASIC/V interpreter through input files that you have stored on disk. Files created using the editor[...]

Chapter 2 87 Command Definitions A-B BASICGO BASICGO Compiles , prepares , and executes a compatibility mode BASIC/V program. B ASIC/V is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately . Syntax BASICGO[ commandfile ] [ , listfile ] P arameters commandfile Actual file designato[...]

88 Chapter 2 Command Definitions A-B BASICGO Example T o compile, prepare , and execute the BASIC/V program MYPROG , enter: BASICGO $ CONTROL USLINIT $ COMPILE MYPROG $ EXIT The above example begins execution of the BASIC/V compiler , initializes the USL, compiles the program MYPROG , and then exits from the compiler . Related Information Commands[...]

Chapter 2 89 Command Definitions A-B BASICOMP BASICOMP Compiles a compatibility mode BASIC/V program. B ASIC/V is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purc hased separately . Syntax BASICOMP[ commandfile ] [ ,[ uslfile ] [ , listfile ] ] P arameters commandfile Actual file designator of[...]

90 Chapter 2 Command Definitions A-B BASICOMP example, below . Y ou may , however , build a USL file in the permanent file domain, then direct the BASIC/V compiler to store the object code in this file by naming the USL file in the BASICOMP command line. Refer to "Examples ." Use This command may be issued from a session, job , or pr[...]

Chapter 2 91 Command Definitions A-B BASICPREP BASICPREP Compiles and prepares a compatibility mode BASIC/V program. B ASIC/V is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately . Syntax BASICPREP[ commandfile ] [ ,[ pr ogfile ] [ , listfile ] ] P arameters commandfile Actual ?[...]

92 Chapter 2 Command Definitions A-B BASICPREP Use This command may be issued from a session, job , or program. It may not be used in BREAK. Pressing Break suspends the execution of this command. Entering the RESUME command continues the execution. Examples T o compile and prepare a program named MYPROG from the BASIC/V fastsave file named MYCOMD[...]

Chapter 2 93 Command Definitions A-B BBASIC BBASIC Starts execution of the HP Business BASIC/V interpreter in compatibility mode . HP Business BASIC/V is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purc hased separately . Syntax BBASIC[ commandfile ] [ ,[ inputfile ] [ , listfile ] ] P arameters[...]

94 Chapter 2 Command Definitions A-B BBASIC Y ou may also submit commands and data to the HP Business B ASIC/V interpreter through input files that you have stored on disk. Files created using the editor must be kept with the UNN (unnumbered) option of the editor's KEEP command. In this example, HP Business BASIC/V interpreter commands and s[...]

Chapter 2 95 Command Definitions A-B BBASICGO BBASICGO Compiles , prepares, and executes an HP Business B ASIC/V program in compatibility mode. HP Business B ASIC/V is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purc hased separately . Syntax BBASICGO infile [ , listfile ] P arameters infile Act[...]

96 Chapter 2 Command Definitions A-B BBASICGO Related Information Commands BBASIC , BBASICOMP , BBASICPREP Manuals HP Business BASIC/XL Reference Manual MPE Segmenter Reference Manual[...]

Chapter 2 97 Command Definitions A-B BBASICOMP BBASICOMP Compiles an HP Business BASIC/V program in compatibility mode . HP Business B ASIC/V is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately . Syntax BBASICOMP infile [ ,[ uslfile ] [ , listfile ] ] P arameters infile Actual ?[...]

98 Chapter 2 Command Definitions A-B BBASICOMP A BSAVE program file can be created from within the HP Business BASIC/V interpreter after it is written, by using the HP Business BASIC/V interpreter >SAVE filename command. The program may be compiled with the BBASICOMP command, then prepared with the PREP command, and executed with the RUN comm[...]

Chapter 2 99 Command Definitions A-B BBASICPREP BBASICPREP Compiles and prepares an HP Business BASIC/V program in compatibility mode . HP Business BASIC/V is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purc hased separately . Syntax BBASICPREP infile [ ,[ pr ogfile ] [ , listfile ] ] P arameter[...]

100 Chapter 2 Command Definitions A-B BBASICPREP Use This command may be issued from a session, job , or program. It may not be used in BREAK. Pressing Break suspends the execution of this command. Entering the RESUME command continues the execution. Example T o compile and prepare a program named MYPROG from the HP Business BASIC/V BSAVE file na[...]

Chapter 2 101 Command Definitions A-B BBXL BBXL Initiates execution of the HP Business BASIC/XL interpreter . HP Business BASIC/XL is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately . (Native Mode) Syntax BBXL[ commandfile ] [ ,[ inputfile ] [ ,[ listfile ] ] ] [ ;XL= xllist ] N[...]

102 Chapter 2 Command Definitions A-B BBXL Use This command may be issued from a session, job , or program. It is not available in BREAK. Pressing Break suspends the execution of this command. Entering the RESUME command continues the execution. Examples T o enter commands and data from your standard input device, with the program listing and outp[...]

Chapter 2 103 Command Definitions A-B BBXLCOMP BBXLCOMP Compiles an HP Business BASIC/XL program. HP Business B ASIC/XL is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately . (Native Mode) Syntax BBXLCOMP textfile [ ,[ objectfile ] [ , listfile ] ] NO TE This command follows the o[...]

104 Chapter 2 Command Definitions A-B BBXLCOMP NO TE The formal file designators used in this command ( BBCIN , BBCOBJ , and BBCLIST ) cannot be backreferenced as actual file designators in the command parameter list. F or further information, refer to the "Implicit FILE Commands for Subsystems" discussion of the FILE command. Operatio[...]

Chapter 2 105 Command Definitions A-B BBXLCOMP Manuals HP Business BASIC/XL Migration Guide HP Business BASIC/XL Reference Manual[...]

106 Chapter 2 Command Definitions A-B BBXLGO BBXLGO Compiles , links, and executes an HP Business B ASIC/XL program. HP Business BASIC/XL is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purc hased separately . (Native Mode) Syntax BBXLGO textfile [ ,[ listfile ] ] [ ;XL =xllist ] NO TE This comman[...]

Chapter 2 107 Command Definitions A-B BBXLGO Use This command may be issued from a session, job , or program. It may not be used in BREAK. Pressing Break suspends the execution of this command. Entering the RESUME command continues the execution.[...]

108 Chapter 2 Command Definitions A-B BBXLGO Example T o compile, link, and execute the HP Business B ASIC/XL program MYPROG and direct the listing to the disk file LISTFL , enter: BBXLGO MYPROG,LISTFL Related Information Commands BBXL , BBXLCOMP , BBXLLK Manuals HP Business BASIC/XL Migration Guide HP Business BASIC/XL Reference Manual[...]

Chapter 2 109 Command Definitions A-B BBXLLK BBXLLK Compiles and links an HP Business BASIC/XL program. HP Business B ASIC/XL is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately . (Native Mode) Syntax BBXLLK textfile [ ,[ pr ogfile ] [ , listfile ] ] NO TE This command follows th[...]

110 Chapter 2 Command Definitions A-B BBXLLK Use This command may be issued from a session, job , or program. It may not be used in BREAK. Pressing Break suspends the execution of this command. Entering the RESUME command continues the execution. Example T o compile and link a source program stored in the HP Business BASIC/XL BASIC SAVE file name[...]

Chapter 2 111 Command Definitions A-B BREAKJOB BREAKJOB Suspends an executing job. (Native Mode) Syntax BREAKJOB #J nnn P arameters #J nnn A job number . Operation Notes The operator can use the BREAKJOB command to suspend any executing job, including spooled and streamed jobs . A job using a critical system resource is not suspended until it rele[...]

112 Chapter 2 Command Definitions A-B BUILD BUILD Creates and immediately allocates a new empty file on disk. Syntax BUILD filer efer encer [;REC=[ [ r ecsize ] [ ,[ blockfactor ] [ ,[ F U V B ] [ ,BINARY ,ASCII ] ] ] ] ] [ ;CCTL [ ;NOCCTL] ] [ ;TEMP] [ ;DEV= [ dsdevice# dsde vice#device [ device ] ] ] [ ;CODE= filecode ] BUILD [ ;DISC=[ [ numr[...]

Chapter 2 113 Command Definitions A-B BUILD • File names can contain (but not begin with ) a dash (-). File names are of the form path/filename where the path/filename combination may have a maximum of 255 characters . r ecsize Record size. A positive number indicates words , while a negative number indicates bytes for new files only . F or ?[...]

114 Chapter 2 Command Definitions A-B BUILD TEMP Indicates that the file is created as a temporary file and is saved in the job/session temporary file domain when closed. The default is that a permanent file is created. dsdevice The device class name or logical device number used to open a communications link to a remote computer that contains[...]

Chapter 2 115 Command Definitions A-B BUILD RIO and NORIO specifications affect only the physical characteristics of the file. If NOBUF is specified in the FILE command, the file is not accessed in RIO mode; otherwise, RIO access is used with RIO files. Special operations on RIO files , such as replicating an RIO file, set NOBUF access . Re[...]

116 Chapter 2 Command Definitions A-B BUILD ;KEY= ( ke ytype,ke ylocation,ke ysize [,DUP|RDUP]; . . ke ytype,ke ylocation,ke ysize [,DUP|RDUP]) One key specification ( ke ytype, ke ylocation, ke ysize [,DUP|RDUP] must be included for each key in the KSAM file . The first occurrence of the key specification describes the primary key; each subse[...]

Chapter 2 117 Command Definitions A-B BUILD If the NOREUSE option is used, deleted record space is not reused. If the DUP option is specified for a key , duplicate records are placed chronologically at the tail end of the file . The default is NOREUSE . langid An integer number indicating the native language of the KSAM file to be built. The de[...]

118 Chapter 2 Command Definitions A-B BUILD Examples The following example creates a permanent disk file named WORKFILE , which can reside on any disk. WORKFILE has fixed length records of 80 bytes each. The records are blocked 3 records per block (which is the blockfactor ), and are written in ASCII code . The file has a maximum capacity of 20[...]

Chapter 2 119 Command Definitions A-B BYE BYE Ends an interactive session. (Native Mode) Syntax BYE P arameters None. Operation Notes This command terminates a session and displays the CPU-time used (in seconds), connect-time (in minutes), and the date and time, as follows: CPU=48. CONNECT=35. FRI, MAY 4, 1987, 10:56 PM If you enter the HELLO comm[...]

120 Chapter 2 Command Definitions A-B BYE[...]

Chapter 3 121 Command Definitions C-E 3 Command Definitions C-E[...]

122 Chapter 3 Command Definitions C-E CALC CALC Evaluates an expression. (Native Mode) Syntax CALC expression NO TE This command follows the optional MPE/iX command line syntax. Refer to "Optional F ormat for MPE/iX Commands" at the beginning of this chapter . P arameters expr ession The expression to be evaluated. Operation Notes The CA[...]

Chapter 3 123 Command Definitions C-E CALC Do not use the FINFO function with the CALC command for remote files. It ignores their existence and returns incorrect information. Use This command is available in a session, job , program, or in BREAK. Pressing Break terminates the INPUT( ) function. Example The result of CALC sample depends on the val[...]

124 Chapter 3 Command Definitions C-E CCXL CCXL Compiles an HP C/iX program. HP C/iX is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purc hased separately . This command is recognized only if HP C/iX is installed on your system. (Native Mode) Syntax CCXL [ textfile ][, [ objectfile ][, [ listfile[...]

Chapter 3 125 Command Definitions C-E CCXL listfile The name of the file on which the compiler writes the program listing . It can be any ASCII file. The default is $STDLIST.$STDLIST is usually the terminal from a session or the printer from a batch job . The formal file designator is CCLIST . If listfile is $NULL or a file other than $STDLI[...]

126 Chapter 3 Command Definitions C-E CCXL Examples The following example compiles an HP C/iX program entered from your standard input device and stores the object program in the object file $OLDPASS . The listing is then sent to your standard list device. CCXL The next example compiles an HP C/iX program contained in the disk file SOURCE and st[...]

Chapter 3 127 Command Definitions C-E CCXLGO CCXLGO Compiles , links, and executes an HP C/iX program. HP C/iX is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purc hased separately . This command is recognized only if HP C/iX is installed on your system. (Native Mode) Syntax CCXLGO [ textfile ][, [[...]

128 Chapter 3 Command Definitions C-E CCXLGO Operation Notes The CCXLGO command compiles , links, and executes an HP C/iX program. If textfile is omitted, the compiler expects input from your standard input device. If you do not specify listfile , the compiler sends the program listing to the formal file designator CCLIST (default is $STDLIST )[...]

Chapter 3 129 Command Definitions C-E CCXLLK CCXLLK Compiles and links an HP C/iX program. HP C/iX is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purc hased separately . This command is recognized only if HP C/iX is installed on your system. (Native Mode) Syntax CCXLLK [ textfile ] [ ,[ [ pr ogfi[...]

130 Chapter 3 Command Definitions C-E CCXLLK Operation Notes The CCXLLK command compiles and links an HP C/iX program into a file on disk. If you do not specify textfile , the compiler expects input from the current input device. If you do not specify listfile , the compiler sends the listing output to the formal file designator CCLIST (defaul[...]

Chapter 3 131 Command Definitions C-E CHANGELOG CHANGELOG Changes the user logging file without stopping or interrupting the logging process . Syntax CHANGELOG logid [ ;DEV= device ] P arameters logid Name of the currently active user logging process . This name may contain from one to eight alphanumeric characters , beginning with an alphabetic [...]

132 Chapter 3 Command Definitions C-E CHANGELOG Mount new tape volume for changelog of logid AAA (ulogmsg 40). Normally when a user logging file is full, the system terminates the logging process and displays an appropriate message . However , by specifying the AUTO parameter in a GETLOG or ALTLOG command, you enable an automatic CHANGELOG , ther[...]

Chapter 3 133 Command Definitions C-E CHANGELOG Related Information Commands ALTLOG , GETLOG , LISTLOG , LOG , OPENLOG , RELLOG , SHOWLOG , SHOWLOGSTATUS Manuals User Logging Programmer's Guide[...]

134 Chapter 3 Command Definitions C-E CHDIR CHDIR Changes the process' current working directory (CWD). (Native Mode) Syntax CHDIR [ [ DIR=] dir_name ] [ ;SHOW | NOSHOW] P arameters dir_name The name of the directory you want to c hange to, which is assumed to be an MPE name unless you specify otherwise. T o change to an HFS-named directory ,[...]

Chapter 3 135 Command Definitions C-E CHDIR Use The CHDIR command may be invoked from a job , a session, a program, or in Break. Pressing Break has no effect on this command. Y ou must have traverse directory entries (TD) permission to each directory component in dir_name (refer to the ALTSEC command in this chapter for more information on directo[...]

136 Chapter 3 Command Definitions C-E CHDIR Related Information Commands CHGROUP , FINDDIR (UDC), LISTFILE , LISTDIR (UDC), NEWDIR , PURGEDIR Manuals P erforming System Management T asks[...]

Chapter 3 137 Command Definitions C-E CHGROUP CHGROUP Switches you from the current group to another group within the logon account to which you are allowed access . (Native Mode) Syntax CHGROUP [ [ gr oupname ][/ gr ouppass ]] NO TE This command follows the optional MPE/iX command line syntax. Refer to "Optional F ormat for MPE/iX Commands&q[...]

138 Chapter 3 Command Definitions C-E CHGROUP Examples T o switch the user from the current group to the group called GORODA , enter: CHGROUP GORODA T o switch the user from the current group to the group called GORODA , with the assigned password MUSASHI , enter: CHGROUP GORODA/MUSASHI T o switch the user from the current group to the user's[...]

Chapter 3 139 Command Definitions C-E COB74XL COB74XL Compiles an HP COBOL II/iX program using the 1974 ANSI standard entry point and creates an object file. HP COBOL II/iX is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purc hased separately . This command is recognized only if HP COBOL II/iX is i[...]

140 Chapter 3 Command Definitions C-E COB74XL The functionality of NMRLS closely maps to the MPE/V USLS . Refer to the HP COBOL/XL Programmer's Guide (31500-90002) for information on the RLINIT and RLFILE commands that cause creation of an NMRL by default or initialization. The compiler may issue an error message telling you that a new or exi[...]

Chapter 3 141 Command Definitions C-E COB74XL Once the file is created, XDB expects the fully qualified name of the file to be unchanged. A FILE equation could be used if the file is renamed. Operation Notes The COB74XL command compiles an HP COBOL II/iX program into an object file on disk. If you do not specify textfile , HP COBOL II/iX exp[...]

142 Chapter 3 Command Definitions C-E COB74XL Program development in native mode uses the MPE/iX LINK command, not the MPE V/E PREP command. This produces a significant change in the method of compiling code . F or example, if you ha ve created a program called MAIN and a subprogram called SUB , each contained in a separate file, you might c hoo[...]

Chapter 3 143 Command Definitions C-E COB74XLG COB74XLG Compiles , links , and executes an HP COBOL II/iX program using the ANSI 1974 standard entry point. HP COBOL II/iX is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purc hased separately . This command is recognized only if HP COBOL II/iX is inst[...]

144 Chapter 3 Command Definitions C-E COB74XLG line make an ampersand ( & ) the last character of one line and continue the quotedstring string onto the next physical line. Eac h $ command is limited in length to the same size as in the source file: COB74XLG SALARIES;INFO="$CONTROL & BOUNDS,MAP,VERBS$SET&$X9=ON" & COB74X[...]

Chapter 3 145 Command Definitions C-E COB74XLG Examples T o compile, link, and execute an HP COBOL II/iX program entered from your standard input device and send the program listing to your standard list device, enter: COB74XLG T o compile, link, and execute an HP COBOL II/iX program from the disk file TEXTFL and send the program listing to the d[...]

146 Chapter 3 Command Definitions C-E COB74XLK COB74XLK Compiles and links an HP COBOL II/iX program using the 1974 ANSI standard entry point. HP COBOL II/iX is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purc hased separately . This command is recognized only if HP COBOL II/iX is installed on your[...]

Chapter 3 147 Command Definitions C-E COB74XLK commands . T o extend the quotedstring string over more than one physical line, make an ampersand ( & ) the last c haracter of one line and continue the quotedstring string onto the next physical line. Each $ command is limited in length to the same size as in the source file: COB74XLK SALARIES,S[...]

148 Chapter 3 Command Definitions C-E COB74XLK Examples T o compile and link an HP COBOL II/iX program entered from your standard input device with the listing printed on the standard list device, enter: COB74XLK T o compile and link an HP COBOL II/iX source program input from the text file SFILE into a program file named MYPROG , with the resul[...]

Chapter 3 149 Command Definitions C-E COB85XL COB85XL Compiles an HP COBOL II/iX program using the 1985 ANSI standard entry point and creates an object file. HP COBOL II/iX is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purc hased separately . This command is recognized only if HP COBOL II/iX is i[...]

150 Chapter 3 Command Definitions C-E COB85XL Refer to the HP COBOL/XL Programmer's Guide (31500-90002) for information on the RLINIT and RLFILE commands that cause creation of an NMRL by default or initialization. The compiler may issue an error message telling you that a new or existing object file is too small to contain the compiler&apos[...]

Chapter 3 151 Command Definitions C-E COB85XL Operation Notes The COB85XL command compiles an HP COBOL II/iX program into an object file on disk. If you do not specify textfile , HP COBOL II/iX expects the source text to be entered from your standard input device. If you do not specify listfile , HP COBOL II/iX sends the program listing to the [...]

152 Chapter 3 Command Definitions C-E COB85XL BUILD RLFILE;DISC=10000;CODE=NMRL COB85XL MAIN, RLFILE COB85XL SUB, RLFILE LINK RLFILE, SOMEPROG RUN SOMEPROG Related Information Commands COB85XLG , COB85XLK , LINK , RUN , XEQ , LINKEDIT Utility Manuals HP COBOL II/XL Reference Manual HP COBOL II/XL Programmer's Guide HP Link Editor/iX Reference[...]

Chapter 3 153 Command Definitions C-E COB85XLG COB85XLG Compiles , links , and executes an HP COBOL II/iX program using the ANSI 1985 standard entry point. HP COBOL II/iX is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purc hased separately . This command is recognized only if HP COBOL II/iX is inst[...]

154 Chapter 3 Command Definitions C-E COB85XLG line, make an ampersand ( & ) the last c haracter of one line and continue the quotedstring string onto the next physical line. Eac h $ command is limited in length to the same size as in the source file: COB85XLG SALARIES;INFO="$CONTROL & BOUNDS,MAP,VERBS$SET&$X9=ON" COB85XLG A[...]

Chapter 3 155 Command Definitions C-E COB85XLG Examples T o compile, link, and execute an HP COBOL II/iX program entered from your standard input device and send the program listing to your standard list device, enter: COB85XLG T o compile, link, and execute an HP COBOL II/iX program from the disk file TEXTFL and send the program listing to the d[...]

156 Chapter 3 Command Definitions C-E COB85XLK COB85XLK Compiles and links an HP COBOL II/iX program using the 1985 ANSI standard entry point. HP COBOL II/iX is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purc hased separately . This command is recognized only if HP COBOL II/iX is installed on your[...]

Chapter 3 157 Command Definitions C-E COB85XLK commands . T o extend the quotedstring string over more than one physical line, make an ampersand ( & ) the last c haracter of one line and continue the quotedstring string onto the next physical line. Each $ command is limited in length to the same size as in the source file: COB85XLK SALARIES,S[...]

158 Chapter 3 Command Definitions C-E COB85XLK Examples T o compile and link an HP COBOL II/iX program entered from your standard input device , with the listing printed on the standard list device, enter: COB85XLK T o compile and link an HP COBOL II/iX source program input from the text file SFILE into a program file named MYPROG , with the lis[...]

Chapter 3 159 Command Definitions C-E COBOLII COBOLII Compiles a compatibility mode COBOLII program on the COBOL 74 compiler . COBOLII is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately . The native mode equivalent of this command is COB74XL . F or information on the 85 entry point[...]

160 Chapter 3 Command Definitions C-E COBOLII listfile Actual file designator of the file to which the program listing is written. This can be any ASCII output file. F ormal file designator is COBLIST . Default is $STDLIST . masterfile Actual file designator of the master file with which textfile is merged to produce a composite source. T[...]

Chapter 3 161 Command Definitions C-E COBOLII Related Information Commands COBOLIIGO , COBOLIIPREP , LINK , RUN , XEQ , LINKEDIT Utility Manuals HP COBOL II/XL Reference Manual[...]

162 Chapter 3 Command Definitions C-E COBOLIIGO COBOLIIGO Compiles , prepares, and executes a compatibility mode COBOLII program on the COBOL 74 compiler . COBOLII is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purc hased separately . The native mode equivalent of this command is COB74XLG . F or in[...]

Chapter 3 163 Command Definitions C-E COBOLIIGO Operation Notes The COBOLIIGO command compiles , prepares , and executes a compatibility mode program using the COBOL 74 compiler . If you do not specify textfile , COBOLII expects the source program to be entered from your standard input device. If you do not specify listfile , COBOLII sends the o[...]

164 Chapter 3 Command Definitions C-E COBOLIIPREP COBOLIIPREP Compiles and prepares a compatibility mode COBOLII program on the COBOL 74 compiler . COBOLII is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purc hased separately . The native mode equivalent of this command is COB74XLK . F or informatio[...]

Chapter 3 165 Command Definitions C-E COBOLIIPREP INFO= quotedstring is used in the COBOLII programming language to pass compiler options to a program. These options appear before the first line of source code in the text file. workspacename This parameter is the actual file designator of an HPT oolset workspace used with HPT oolset. The formal[...]

166 Chapter 3 Command Definitions C-E COMMENT COMMENT Inserts a comment into a command stream or user command. (Native Mode) Syntax COMMENT [ text ] or # [ text ] P arameters text Information composed of the comment text. If the last nonblank character is an ampersand ( & ), comment text is continued onto the next line. Default is that a recor[...]

Chapter 3 167 Command Definitions C-E CONSOLE CONSOLE Changes the system console from its current device to another job-accepting terminal. Syntax CONSOLE [ ldev ] P arameters ldev The logical device number of the new console terminal. If omitted, the CONSOLE command displays the current logical device number of the console. Operation Notes The CO[...]

168 Chapter 3 Command Definitions C-E CONSOLE Use This command may be issued from a session, job , program, or in BREAK. Pressing Break has no effect on this command. It may be used by any user to determine the location of the console. T o change the location of the console , this command must be issued from the console itself , unless distributed[...]

Chapter 3 169 Command Definitions C-E CONTINUE CONTINUE Overrides a job error so that the job or user command (command file or UDC) continues executing . (Native Mode) Syntax CONTINUE P arameters None. Operation Notes The CONTINUE command permits a job or session to continue even though the command immediately following the CONTINUE command resul[...]

170 Chapter 3 Command Definitions C-E CONTINUE Related Information Commands JOB Manuals Appendix A, "Predefined V ariables in MPE/iX"[...]

Chapter 3 171 Command Definitions C-E COPY COPY Copies one file to another by creating a new file or by overwriting an existing file. The COPY command can be used to copy files to and from HFS directories . Y ou cannot use COPY to copy directories to or from other directories. Users with SM capabilities are able to copy files to MPE accounts [...]

172 Chapter 3 Command Definitions C-E COPY N or NO Instructs COPY to terminate. ASK is the default, except in a job or in other cases when the user is not using interactive mode. In suc h cases, ASK has no meaning, and YES becomes the default. YES Instructs COPY to purge targ etfile if it already exists. No message is displayed for the user , as [...]

Chapter 3 173 Command Definitions C-E COPY In the next example the file MYFILE.PUB.SYS is copied to MyFile under the current working directory (CWD). Note that the target file name has to have the dot and slash (./) prefix. COPY myfile.pub.sys, ./MyFile In the next example, the file File1 under the CWD is copied to MYFILE.PUB in the current ac[...]

174 Chapter 3 Command Definitions C-E D ATA D ATA Enters data into the system from a device file. (Cannot be used to enter data from $STDIN .) (Native Mode) Syntax DATA [ jsname ,] username [/ userpass ]. acctname [/ acctpass ][; filename ] P arameters jsname Name of job or session that is to read data. Default is no job/session name. It may con[...]

Chapter 3 175 Command Definitions C-E D ATA Operation Notes This command identifies data to be read from a device file other than your standard job/session input device. It can be used, for example , to input a data file from a spooled input device for later use by an interactive session or a batch job . The DATA command is the only command tha[...]

176 Chapter 3 Command Definitions C-E D ATA Examples A data file is created on disk, and the STREAM command is used to make the file available to your program. T o create the file DATAFL on disk, invoke a text editor (like EDITOR ) and enter the data beginning with the DATA command and ending with the EOD command. F or example: EDITOR / ADD DAT[...]

Chapter 3 177 Command Definitions C-E DEALLOCA TE DEALLOCA TE Deallocates a program or procedure previously loaded into memory with the ALLOCATE command. Syntax DEALLOCATE [ PROGRAM | PROCEDURE ] ,name P arameters PROGRAM The program file indicated by name is deallocated. Default. PROCEDURE The code segment containing the procedure specified by [...]

178 Chapter 3 Command Definitions C-E DEALLOCA TE Manuals Introduction to MPE XL for MPE V Programmers[...]

Chapter 3 179 Command Definitions C-E DEBUG DEBUG Instructs MPE/iX to enter the system debugger . (Native Mode) Syntax DEBUG [ commands ] P arameters commands A series of system debugger commands to be executed before the debugger prompt is displayed. The string may be as many as 255 c haracters long. There are no delimiters or keywords needed to [...]

180 Chapter 3 Command Definitions C-E DEBUG 6) SP=40221130 RP=7d.00000000 (end of NM stack) : Related Information Commands RESETDUMP , RUN , SETDUMP Manuals System Debug Reference Manual[...]

Chapter 3 181 Command Definitions C-E DELETESPOOLFILE DELETESPOOLFILE Deletes a spoolfile from disk. Syntax DELETESPOOLFILE {# O nnn #I nnn ldev } P arameters #O nnn The identification of a READY or ACTIVE output spoolfile . #I nnn The identification of a READY , input spooled data file. ldev The logical device number on which the spoolfile [...]

182 Chapter 3 Command Definitions C-E DELETESPOOLFILE When you put the device back online , the trailer page is printed, and the file deleted. If you have suppressed header/trailer output with the HEADOFF command, no trailer is printed before the spoolfile is deleted. However , the printer skips to the top of the next physical page. If the devic[...]

Chapter 3 183 Command Definitions C-E DELETEV AR DELETEV AR Deletes one or more MPE/iX variables . (Native Mode) Syntax DELETEVAR varname [, varname ] ... [ , varname ] NO TE This command follows the optional MPE/iX command line syntax. Refer to "Optional F ormat for MPE/iX Commands" at the beginning of this chapter . P arameters varname[...]

184 Chapter 3 Command Definitions C-E DELETEV AR Use This command is available in a session, job , program, or in BREAK. Pressing Break has no effect on this command. Examples T o delete two specific variables, enter: DELETEVAR firstvariable, secondvariable T o delete all variables beginning with a single alphabetic character and ending with the[...]

Chapter 3 185 Command Definitions C-E DISALLO W DISALLOW Prohibits access to a specific operator command. Syntax DISALLOW FILE=formaldesignator[ ;SHOW] DISALLOW] [ @.@ user .@ @.user user .acct ] ;COMMANDS= command [ , command ,...] P arameters formal- designator An ASCII file name, which ma y consist of one to eight alphanumeric characters , be[...]

186 Chapter 3 Command Definitions C-E DISALLO W NO TE Do NOT confuse operator commands with console commands. F or a description of the difference between console and operator commands refer to the ALLOW command. The commands which may be disallowed are the same as the commands which may be allowed. Refer to the ALLOW command for a list of command[...]

Chapter 3 187 Command Definitions C-E DISALLO W Related Information Commands ALLOW , SHOWALLOW Manuals P erforming System Operation T asks[...]

188 Chapter 3 Command Definitions C-E DISASSOCIA TE DISASSOCIA TE Removes control of a device class from the user . Syntax DISASSOCIATE devclass P arameters devclass The name of a device class configured during SYSGEN . Operation Notes This command negates a previously issued ASSOCIATE command by removing control of a device class from a user . T[...]

Chapter 3 189 Command Definitions C-E DISCRPS DISCRPS Enables or disables the rotational position sensing (RPS) feature on a specified logical device. It requires a special firmw are upgrade CS-80 disk drives . Syntax DISCRPS ldev { ,ENABLE [ { , value ,value } ] ,DISABLE } P arameters ldev The logical device number of the specified CS-80 disk [...]

190 Chapter 3 Command Definitions C-E DISCRPS Example T o enable the RPS feature on logical device 1 and display the status of the disk drive, enter: DISCRPS 1,ENABLE SHOWDEV 1 LDEV AVAIL OWNERSHIP VOID DEN ASSOCIATION 1 DISC (RPS) 50 FILES T o use the value parameter with ENABLE to set time-to-target and window size to the default values , enter:[...]

Chapter 3 191 Command Definitions C-E DISCUSE (UDC) DISCUSE (UDC) The DISCUSE UDC executes the DISKUSE command to display disk space usage, in sectors , for one or more directories or a directory tree. This UDC is provided for those who are used to spelling disk with a "c". System-defined UDCs are not automatically available . Y our Sys[...]

192 Chapter 3 Command Definitions C-E DISCUSE (UDC) Refer to the DISKUSE command later in this chapter for additional examples. Related Information Commands DISKUSE , LISTFILE , REPORT[...]

Chapter 3 193 Command Definitions C-E DISKUSE DISKUSE Displays disk space usage , in sectors, for one or more directories or a directory tree . Syntax DISKUSE [ [ DIR=] dir_name ] [ ; TREE | NO TREE | USENAME ] P arameters dir_name Directory name for which information is being listed (optional). The dir_name is assumed to be an MPE syntax name. HF[...]

194 Chapter 3 Command Definitions C-E DISKUSE Use Y ou must have traverse directory entries (TD) and read directory entries (RD) permissions 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[...]

Chapter 3 195 Command Definitions C-E DISKUSE Examples The illustration below shows a hierarchical directory structure , upon which all of the succeeding examples are based. Directory names are shown as the character d plus a number (for example, d0 ), and file names are shown as the character f plus a number (for example f1 ). F or illustrative [...]

196 Chapter 3 Command Definitions C-E DISKUSE directory . The sum of the number of sectors reported by the following command equals the number shown under the LEVEL BELOW column. The number in the LEVEL BELOW column is zero if the reported directory is empty . LISTFILE dir_name /@,2;NOTREE TREE (right-justified) Displays the total number of secto[...]

Chapter 3 197 Command Definitions C-E DISKUSE NO TE The output is presented in HFS syntax, even if the directory name is supplied in MPE syntax. If wildcards were used to specify the directory name in MPE syntax, then the final line of output is the user -supplied directory name (upshifted) in MPE format. Wildcards can be used to see a "hori[...]

198 Chapter 3 Command Definitions C-E DISMOUNT DISMOUNT Releases a volume set that was explicitly reserved by the user with a MOUNT or VSRESERVE command. The equivalent native mode command is VSRELEASE . (Native Mode) Syntax DISMOUNT [{ * volumesetname }][. gr oupname [. acctname ]] P arameters * or <blank> Specifies the home volume set for[...]

Chapter 3 199 Command Definitions C-E DISMOUNT T able 3-3 Command Acceptance of Naming Conventions - DISMOUNT Command In MPE V/E, the name V.G.A indicates that V is the name of a volume set, that G is the name of a group, and that A is the name of an account. MPE/iX accepts the V.G.A. name in that form, but no interpretation is made as to the refe[...]

200 Chapter 3 Command Definitions C-E DISMOUNT Examples T o release the volume set MYSET.B.C , that was previously reserved with a MOUNT or VSRESERVE command, enter: DISMOUNT MYSET.B.C Y ou may also use the VSRELEASE command: VSRELEASE MYSET.B.C Related Information Commands MOUNT , LMOUNT , DSTAT , VSRESERVE , VSRELEASE Manuals V olume Management [...]

Chapter 3 201 Command Definitions C-E DO DO Allows the user to reexecute any command still retained in the command line history stack. It also permits the user to edit the command before reexecuting it, but without having to use the interactive mode of the REDO command. (Native Mode) Syntax DO [ CMD= cmdid ] [ ;EDIT= editstring ] NO TE This comman[...]

202 Chapter 3 Command Definitions C-E DO T able 3-5 Editing Directives for the DO Command Directive Effect i INSERT . If text follows the i , the text following i is inserted in the current line at the position after the i . r REPLACE . If text follows the r , the text following r replaces the same number of characters in the current line , beginn[...]

Chapter 3 203 Command Definitions C-E DO v delim DOWNSHIFT TO DELIMITER . Downshifts all characters starting at the position of the v and ending at, but not including , the specified delimiter . If delim is not found, no downshift occurs . Y ou may follow this directive with other edits . v> DOWNSHIFT TO EOL . Downshifts all characters startin[...]

204 Chapter 3 Command Definitions C-E DO NO TE A word is defined as a grouping of characters delimited by a space, comma, semicolon, =, (, ), “ , ‘, tab. Operation Notes Reexecutes the command specified by cmdid . The user may specify an optional edit string to edit the command before it is reexecuted. This command is a companion to the enha[...]

Chapter 3 205 Command Definitions C-E DO T able 3-6 Editing Samples for the DO Command Edit Action u First occurrence undoes the previous edits . The u must be in column one. u Second occurrence undoes all edits on the current line. The u must be in column one. rxyz Replaces the current text with xyz starting at the position of r . xyz Replaces th[...]

206 Chapter 3 Command Definitions C-E DO Examples DO PAS Reexecutes the most recent command beginning with the string PAS . DO 10 Reexecutes command number 10 (absolute) on the command history stack. DO -2 Reexecutes the second-to-last command on the stack (one command before the most recent). DO -2, c/5A/5B Change all occurrences of 5A to 5B in t[...]

Chapter 3 207 Command Definitions C-E DOIONO W DOIONOW Executes the changes to the I/O configuration made with the SYSGEN utility , while the system remains online. Syntax DOIONOW P arameters None. Operation Notes Use the DOIONOW command to start the online reconfiguration of your I/O devices. Use This command is available from a job , session, [...]

208 Chapter 3 Command Definitions C-E DO WN DOWN Removes a device from normal system use. This command does not apply to the system console or to disk drives . Syntax DOWN ldev P arameters ldev The logical device number of the device being taken offline . Operation Notes When the DOWN command is issued for a device that is in use, the request is [...]

Chapter 3 209 Command Definitions C-E DO WN Related Information Commands SHOWDEV , UP , ABORTIO Manuals P erforming System Operation T asks[...]

210 Chapter 3 Command Definitions C-E DO WNLO AD DOWNLOAD Downloads format information to a line printer . Syntax DOWNLOAD ldev [, filename ,MARGIN= nn ] [ ,...] P arameters ldev The logical device number of the output device . This device must be an HP 2608 or HP 2563 Line Printer . filename The fully qualified name of a file containing the d[...]

Chapter 3 211 Command Definitions C-E DO WNLO AD Use This command may be issued from a session, job , program, or in BREAK. Pressing Break has no effect on this command. It may be issued only from the console unless distributed to users with the ALLOW or ASSOCIATE command. Examples T o respond to a forms message such as the following: IO/15:46/22/[...]

212 Chapter 3 Command Definitions C-E D S TAT D S TAT Displays the current status of the disk drives on the system. (Native Mode). Syntax DSTAT [ ldev ALL ] P arameters ldev An integer specifying the logical device number of the disk drive whose status is requested. ALL Displays the status of all disk drives , both system and nonsystem. The defaul[...]

Chapter 3 213 Command Definitions C-E D S TAT If you have purchased Mirrored Disk/XL, you ma y see PENDING or DISABLED as well. PENDING indicates the partner disk failed to mount; DISABLED indicates the volume is not abailable to the system due to a disk failure. If you ha ve Mirrored Disk/XL you also may see the following suffixes in the status [...]

214 Chapter 3 Command Definitions C-E ECHO ECHO Displays a message on the standard list device . (Native Mode) Syntax ECHO [ message ] P arameters message The message to be displa yed to the $STDLIST . Operation Notes Displays its argument, message , on the standard list device ( $STDLIST ). The command ignores delimiters . Quotation marks are not[...]

Chapter 3 215 Command Definitions C-E ECHO ECHO !a !hi there If you entered the following command line in a user command, you would see a message when an error occurred: IF CIERROR <> 0 THEN ECHO ** A CIERROR OCCURRED!: (CIERR !CIERROR) ** The first instance of CIERROR has no dereferencing, and so ECHO treats it literally . The second insta[...]

216 Chapter 3 Command Definitions C-E EDIT OR EDITOR Starts the EDIT/3000 subsystem, which is used to create and manipulate ASCII text or program files . Syntax EDITOR [ listfile ] P arameters listfile Actual file designator of file to receive any output resulting from EDIT/3000 LIST and XPLAIN commands when the OFFLINE option is specified. [...]

Chapter 3 217 Command Definitions C-E ELSE ELSE Provides an alternate execution sequence within an IF statement. (Native Mode) Syntax ELSE P arameters None. Operation Notes The ELSE command is used only in conjunction with the IF and ELSEIF commands. The IF command is used with the ENDIF command, and optionally with the ELSE command, to control th[...]

218 Chapter 3 Command Definitions C-E ELSEIF ELSEIF Provides an alternate execution sequence within an IF statement. Native Mode Syntax ELSEIF expr ession [ THEN] P arameters expr ession Logical expression, consisting of operands and relational operators. The THEN keyword is optional. It may be used or omitted and has no effect on the results . Th[...]

Chapter 3 219 Command Definitions C-E ELSEIF Example The following example illustrates using the ELSE command with the IF command: IF EXPN1 THEN ... ELSE IF EXPN2 THEN ... ELSE IF EXPN3 THEN ... ELSE ... ENDIF ENDIF ENDIF The same result can be accomplished more efficiently by using the ELSEIF command: IF EXPN1 THEN ... ELSEIF EXPN2 THEN ... ELSE[...]

220 Chapter 3 Command Definitions C-E ENDIF ENDIF T erminates an IF block. (Native Mode) Syntax ENDIF P arameters None. Operation Notes The ENDIF command is used to terminate an IF block. The IF command, the optional ELSE and ELSEIF commands , and the ENDIF command constitute an IF block. A logical expression is evaluated, and if true, the IF bloc[...]

Chapter 3 221 Command Definitions C-E END WHILE ENDWHILE T erminates a WHILE block. (Native Mode) Syntax ENDWHILE P arameters None Operation Notes This command terminates a conditional block that begins with a WHILE command. The WHILE and ENDWHILE commands constitute a WHILE block. The WHILE command evaluates an expression, and so long as that exp[...]

222 Chapter 3 Command Definitions C-E EOD EOD Denotes end-of-data on input stream from a job file (from an input other than $STDIN ). It also terminates data initialized by the DATA command. The colon ( : ) is a required part of this command. (Native Mode) Syntax EOD NO TE The "&" symbol has no meaning to the input spooler when it r[...]

Chapter 3 223 Command Definitions C-E EOD Use EOD is available only in a job or a session that is submitted with the STREAM command. It cannot be used directly from $STDIN or from a program. Examples T o terminate a data file entered by using the STREAM command for a session identified as SESS1,BLACK.ACCTSP , your data file would contain EOD as[...]

224 Chapter 3 Command Definitions C-E EOJ EOJ Ends a batch job . (Native Mode) Syntax EOJ NO TE The "&" symbol has no meaning to the input spooler when it reads records because the CI is not involved at that point. P arameters None. Operation Notes The EOJ command terminates a batch job and displays the CPU-time (in seconds) and the [...]

Chapter 3 225 Command Definitions C-E ERRCLEAR ERRCLEAR Zeros out all HP predefined error -related variables . (Native Mode) Syntax ERRCLEAR NO TE This command follows the optional MPE/iX command line syntax. Refer to "Optional F ormat for MPE/iX Commands" at the beginning of this chapter . P arameters None Operation Notes This command [...]

226 Chapter 3 Command Definitions C-E ERRDUMP ERRDUMP Allows a user to dump either the process or system error stack to a specified depth. (Native Mode) Syntax ERRDUMP [ err orstackdepth ] [ ;SYS] NO TE This command follows the optional MPE/iX command line syntax. Refer to "Optional F ormat for MPE/iX Commands" at the beginning of this [...]

Chapter 3 227 Command Definitions C-E ERRDUMP Use This command may be issued from a session, job , program, or in BREAK. Pressing Break has no effect on this command. Examples T o obtain an error stack dump, enter: ERRDUMP A sample system response is: TYPE MANAGER; THE END-OF-FILE HAS BEEN DETECTED. FILE SYSTEM MESSAGE 1023. Another example speci?[...]

228 Chapter 3 Command Definitions C-E ESCAPE ESCAPE Allows the CI programmer to simulate all aspects of CI error handling . (Native Mode) Syntax ESCAPE [ [ CIERR=] errnum ] P arameters ERRNUM Sets the CIERROR variable to the absolute value of errnum and the HPCIERR variable is set to errnum . Operation Notes The ESCAPE command causes control to le[...]

Chapter 3 229 Command Definitions C-E ESCAPE Related Information Commands ERRCLEAR , RETURN Manuals MPE/iX Commands Reference Manual V olumes I and II Command Interpreter Access and V ariables Programmer's Guide[...]

230 Chapter 3 Command Definitions C-E EXIT EXIT T erminates the command interpreter . (Native Mode) Syntax EXIT P arameters None Operation Notes When you are using MPE/iX you can start another Command Interpreter by running it as a program. T o do so, you enter CI.PUB.SYS , or simply CI . If you enter this command more than once, you will create l[...]

Chapter 4 231 Command Definition F-K 4 Command Definition F-K[...]

232 Chapter 4 Command Definition F-K FCOPY FCOPY Invokes the FCOPY subsystem. Syntax FCOPY [ fcopycommand ] P arameters fcopycommand An FCOPY subsystem command. The FCOPY subsystem enables you to copy files or selected portions of files from any supported input device to any supported output device. There are many commands; only the most common [...]

Chapter 4 233 Command Definition F-K FCOPY Related Information Commands COPY Manuals FCOPY Reference Manual[...]

234 Chapter 4 Command Definition F-K FILE FILE Declares the file attributes to be used when a file is opened. This declaration, informally known as a file equation, may be used to override programmatic or system default file specifications . With the addition of shared parameters from the NS3000/XL AdvanceNet subsystem, the declaration may sp[...]

Chapter 4 235 Command Definition F-K FILE $NULL Actual file designator of a system-wide file that is alwa ys treated as an empty file. When $NULL is accessed by a program for input, that program receives only an end-of-file indication. When it is accessed by a program for output, the associated write request is accepted by MPE/iX, but no physi[...]

236 Chapter 4 Command Definition F-K FILE If the name begins with a dot (.) or a slash (/), the name is considered to follow the HFS file naming syntax rules: • File names are not upshifted. • File names can be up to 255 characters in length for absolute pathnames and 253 characters for relative pathnames . • File names can begin with, and [...]

Chapter 4 237 Command Definition F-K FILE nodespec parameter is optional; if you do not have NS3000/XL AdvanceNet, omitting the nodespec parameter makes no difference in the performance of the FILE command. However , specifying nodespec on a system that does not have NS3000/XL produces an error . The nodespec parameter is controlled by the NS3000/[...]

238 Chapter 4 Command Definition F-K FILE If you are opening a file that is to reside on a movable volume set, you must specify a device class that includes the drives upon which the home volume set is mounted. The file is then allocated to any of the volume set's volumes that fall within that device class . outpri The output priority reque[...]

Chapter 4 239 Command Definition F-K FILE P arameters for Option r ecsize Record size. A positive number indicates words; a negative number indicates bytes for new files only . F or fixed-length files, this is the logical record size. F or undefined length files , this is the maximum record size. F or variable-length files, this is the maxim[...]

240 Chapter 4 Command Definition F-K FILE The density value from a file equation takes precedence over the density specified in FOPEN or HPFOPEN . The supported densities are 800, 1600, and 6250. F or details on the operation of density selection, refer to the FOPEN and HPFOPEN intrinsics in the MPE/iX Intrinsics Reference Manual (32650-90028). [...]

Chapter 4 241 Command Definition F-K FILE KSAMXL specifies a native mode KSAM file (KSAM XL file). SPOOL specifies an output spool file. No spooling attributes are initialized. PRI is set to 8 and number of copies to 1. No output device is set. This spool file will not be linked to the spool file directory (SPFDIR) and, therefore, will not [...]

242 Chapter 4 Command Definition F-K FILE ke ysize Length of the KSAM key , in bytes. This parameter is required for all key types . Different ke ytypes have different lengths , as described below: DUP or RDUP These two options apply only to KSAM files. Specify the DUP option if you want duplicate key values to be permitted. If you don't spe[...]

Chapter 4 243 Command Definition F-K FILE P arameters for Access NOCCTL or CCTL Indicates whether or not carriage-control characters are specified. NOCCTL indicates that carriage-control characters are not being specified in writes to the file. CCTL indicates that carriage-control characters are being supplied in writes to the file. Default is[...]

244 Chapter 4 Command Definition F-K FILE formsmsg A message to the operator requesting that certain forms be mounted. The message must be displayed and verified before the output data can be printed on a line printer . The message is a string of no more than 49 ASCII characters terminated by a period. Control characters for bells and inverse vid[...]

Chapter 4 245 Command Definition F-K FILE formid Applies only to output spoolfiles . A string of up to eight alphanumeric characters , beginning with a letter , which uniquely identifies a special form that is to be mounted. A message displaying this formid is printed on the system console or $STDLIST of the associated user of the spooled device[...]

246 Chapter 4 Command Definition F-K FILE T o use the FILE command for a file, you must have a valid, formal file designator (the name by which your program recognizes the file). The formal file designator provides a w ay for commands and code outside your program to reference the file. The FILE command is the only wa y you can control or cha[...]

Chapter 4 247 Command Definition F-K FILE The following is an example of using the *formaldesignator , in this case, specifying a file on magnetic tape used as a source file during FORTRAN compilation: FILE SOURCE=TAPE1,OLD;DEV=TAPE;REC=-80 FTNXL *SOURCE Implicitly , the command executor issues the following FILE command, backreferencing your pr[...]

248 Chapter 4 Command Definition F-K FINDDIR (UDC) FINDDIR (UDC) The FINDDIR UDC executes the LISTFILE command to search for a directory . NO TE System-defined UDCs are not automatically available . Y our System Manager must use the SETCATALOG command to make these UDCs available for your use. F or example: SETCATALOG HPPXUDC.PUB.SYS;SYSTEM;APPEN[...]

Chapter 4 249 Command Definition F-K FINDFILE (UDC) FINDFILE (UDC) The FINDFILE UDC executes the LISTFILE command to search for a file. NO TE System-defined UDCs are not automatically available . Y our System Manager must use the SETCATALOG command to make these UDCs available for your use. F or example: SETCATALOG HPPXUDC.PUB.SYS;SYSTEM;APPEND [...]

250 Chapter 4 Command Definition F-K FORMSALIGN FORMSALIGN Configures one spooled printer or a group of spooled printers related by device class , to conditionally enter into a forms message dialog with its operator (s) when the current spoolfile includes a forms message . Syntax FORMSALIGN[DEV=]{ldev | devclass | devname } [;[DIALOG=]{{EACHCHAN[...]

Chapter 4 251 Command Definition F-K FORMSALIGN formids match, both the DIALOG option for the spooler process and any forms message in the current spoolfile are ignored, and the forms message dialog is not activated. Identical formids override all other considerations . Note that the DIALOG option is not changed. It is ignored as long as the two [...]

252 Chapter 4 Command Definition F-K FORMSALIGN NOFORMIDOVERRIDE This is a sub-parameter of the chosen EACHxxx keyvalue. With this feature selected, the Native Mode Spooler ignores any and all formids associated with the current spoolfile or the previous spoolfile. The setting of the DIALOG option always determines the conditions under which the[...]

Chapter 4 253 Command Definition F-K FORMSALIGN NO TE This command effects more than one device (if applied to all devices in a class). Y ou may get w arning messages for some devices and not others . A warning message on one or more devices affects only that device . The command will continue to execute until all selected devices have been confi[...]

254 Chapter 4 Command Definition F-K FORTGO FORTGO Compiles , prepares, and executes a compatibility mode FORTRAN 66/V program. FORTRAN 66/V is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purc hased separately . Syntax FORTGO [ textfile ][, [ listfile ][, [ masterfile ][, [ newfile ] ] ] ] [ ;I[...]

Chapter 4 255 Command Definition F-K FORTGO The USL file created during the compilation is a system-defined temporary file $OLDPASS , which is passed directly to the MPE segmenter , and cannot be accessed. Use This command may be issued from a session, job , or program. It may not be used in BREAK. Pressing Break suspends the execution of this [...]

256 Chapter 4 Command Definition F-K FORTPREP FORTPREP Compiles and prepares a compatibility mode FORTRAN 66/V program. FORTRAN 66/V is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately . Syntax FORTPREP [ textfile ][, [ pr ogfile ][, [ listfile ][, [ masterfile ][, [ ne wfile ][...]

Chapter 4 257 Command Definition F-K FORTPREP NO TE The formal file designators used in this command ( FTNTEXT , FTNLIST , FTNMAST , and FTNNEW ) cannot be backreferenced as actual file designators in the command parameter list. F or further information, refer to the "Implicit FILE Commands for Subsystems" discussion of the FILE comman[...]

258 Chapter 4 Command Definition F-K FORTRAN FORTRAN Compiles a compatibility mode FORTRAN 66/V program. FORTRAN 66/V is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately . Syntax FORTRAN [ textfile ][, [ uslfile ][, [ listfile ][, [ masterfile ][, [ newfile ]]]]][ ;INFO= quoted[...]

Chapter 4 259 Command Definition F-K FORTRAN quotedstring A sequence of characters between two single quotation marks (apostrophes) or between two double quotation marks . Y ou may use the delimiter as part of the string so long as the delimiter appears twice. Any occurrence of two single or two double quotation marks in a row , is considered part[...]

260 Chapter 4 Command Definition F-K FORTRAN T o compile a FORTRAN 66/V program and store the object code into a USL file you create with the BUILD command, enter: BUILD OBJECT;CODE=USL FORTRAN SOURCE,OBJECT,LISTFL T o create a USL file with the BUILD command, the code must be specified. Related Information Commands FORTGO , FORTPREP , RUN , XE[...]

Chapter 4 261 Command Definition F-K FREERIN FREERIN Releases a global resource identification number (RIN). Syntax FREERIN rin P arameters rin The resource identification number (RIN) to be released. It must be a number from one to the configured maximum. Operation Notes A resource identification number is used to manage a resource shared by [...]

262 Chapter 4 Command Definition F-K FTN FTN Compiles a compatibility mode FORTRAN 77/V program. FORTRAN 77/V is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately . The native mode equivalent of this command is FTNXL . Syntax FTN [ textfile ][, [ uslfile ][, [ listfile ] ] ] [ ;IN[...]

Chapter 4 263 Command Definition F-K FTN If you create the USL prior to compilation, you must specify a file code of USL or 1024 . If you omit the uslfile parameter , the object code is saved in the temporary file domain as $OLDPASS . T o keep it as a permanent file, you must save $OLDPASS under another name. Y ou cannot backreference the form[...]

264 Chapter 4 Command Definition F-K FTNGO FTNGO Compiles , prepares, and executes a compatibility mode HP FORTRAN 77/V program. HP FORTRAN 77/V is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purc hased separately . The native mode equivalent of this command is the FTNXLGO command. Syntax FTNGO [ t[...]

Chapter 4 265 Command Definition F-K FTNGO Use This command may be issued from a session, job , or program. It may not be used in BREAK. Pressing Break suspends the execution of this command. Entering the RESUME command continues the execution. Examples T o compile, prepare , and execute an HP FORTRAN 77/V program entered from your standard input [...]

266 Chapter 4 Command Definition F-K FTNPREP FTNPREP Compiles and prepares a compatibility mode HP FORTRAN 77/V program. HP FORTRAN 77/V is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purc hased separately . The native mode equivalent of this command is the FTNXLLK command. Syntax FTNPREP [ textfi[...]

Chapter 4 267 Command Definition F-K FTNPREP Operation Notes The FTNPREP command compiles and prepares a compatibility mode HP FORTRAN 77/V program into a program file on disk. If you do not specify textfile , MPE/iX expects input from the current input device. If you do not specify listfile , MPE/iX sends the listing output to the formal file[...]

268 Chapter 4 Command Definition F-K FTNXL FTNXL Compiles an HP FORTRAN 77/iX program. HP FORTRAN 77/iX is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purc hased separately . This command is recognized only if HP FORTRAN 77/iX is installed on your system. (Native Mode) Syntax FTNXL [ textfile ][, [...]

Chapter 4 269 Command Definition F-K FTNXL The info string used in the HP FORTRAN 77/iX programming language to pass initial compiler options to the HP FORTRAN 77/iX compiler . HP FORTRAN 77/iX places a single dollar sign ( $ ) before the info string and places the string before the first line of source code in the text file. NO TE The formal ?[...]

270 Chapter 4 Command Definition F-K FTNXL FTN MAIN, SOMEUSL FTN SUB, SOMEUSL : PREP SOMEUSL, SOMEPROG : RUN SOMEPROG The second command appends the code from SUB to SOMEUSL . However , LINK (in MPE/iX native mode) does not append SUB . On MPE/iX, you must compile the source files into separate object files and then use the Link Editor to link t[...]

Chapter 4 271 Command Definition F-K FTNXLGO FTNXLGO Compiles , links, and executes an HP FORTRAN 77/iX program. HP FORTRAN 77/iX is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately . This command is recognized only if HP FORTRAN 77/iX is installed on your system. (Native Mode) Synt[...]

272 Chapter 4 Command Definition F-K FTNXLGO Operation Notes The FTNXLGO command compiles , links, and executes an HP FORTRAN 77/iX program. If textfile is omitted, MPE/iX expects input from your standard input device . If you do not specify listfile , MPE/iX sends the program listing to the formal file designator FTNLIST (default is $STDLIST )[...]

Chapter 4 273 Command Definition F-K FTNXLLK FTNXLLK Compiles and links an HP FORTRAN 77/iX program. HP FORTRAN 77/iX is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately . This command is recognized only if HP FORTRAN 77/iX is installed on your system. (Native Mode) Syntax FTNXLLK [[...]

274 Chapter 4 Command Definition F-K FTNXLLK Operation Notes The FTNXLLK command compiles and links an HP FORTRAN 77/iX program into a disk file. If you do not specify textfile , HP FORTRAN 77/iX expects your input from your standard input device. If you do not specify listfile , HP FORTRAN 77/iX sends the listing output to your current list de[...]

Chapter 4 275 Command Definition F-K GETLOG GETLOG Establishes a logging identifier on the system. Syntax GETLOG logid ;LOG= logfile { ,DISC ,TAPE ,SDISC ,CT APE } [ ;P ASS= passwor d ][{ ; A U T O ;NOA UTO } ] P arameters logid The logging identifier to be established. This must contain from one to eight alphanumeric characters beginning with [...]

276 Chapter 4 Command Definition F-K GETLOG If a log file is restricted to a single volume or volume class when it is created with the BUILD command, then successive log files created by User Logging will have the same restriction. If a new log file name is specified with the ALTLOG command, the links with any previous log file are broken. Th[...]

Chapter 4 277 Command Definition F-K GETRIN GETRIN Acquires a global resource identification number (RIN) and assigns a password to it. Syntax GETRIN rinpassword P arameters rinpasswor d P assword of the intrinsic that locks the RIN . The password must contain from one to eight alphanumeric characters , beginning with an alphabetic character . Op[...]

278 Chapter 4 Command Definition F-K GETRIN Related Information Commands FREERIN Manuals Resource Management Programmer's Guide[...]

Chapter 4 279 Command Definition F-K HEADOFF HEADOFF Stops header/trailer output to a device. (Native Mode) Syntax HEADOFF ldev P arameters ldev The logical device number of the printer affected by the command. Operation Notes Header and trailer information appears before and after a file when it is printed. This information is not a part of the [...]

280 Chapter 4 Command Definition F-K HEADON HEADON Resumes header/trailer output to a device. (Native Mode) Syntax HEADON ldev P arameters ldev The logical device number of the printer affected by the command. Operation Notes Header and trailer information appears before and after a file when it is printed. This information is not a part of the ?[...]

Chapter 4 281 Command Definition F-K HELLO HELLO Initiates an interactive session. (Native Mode) Syntax HELLO [ sessionname ,] username [/ userpass ]. acctname [/ acctpass ][, groupname [/ gr ouppass ] ] [ ;TERM={ termtype termname } ] [ ;TIME= cpusecs ] [ ;PRI={ BS CS DS ES } ] [ { ;INPRI= inputpriority ;HIPRI } ] [ ;INFO= ciinfo ] [ ;P ARM= cipa[...]

282 Chapter 4 Command Definition F-K HELLO factors for carriage returns . It must be 10 or 18. The default value for termtype is assigned by the system supervisor during system configuration. This is a required parameter to ensure correct listings if your terminal is not the default termtype . The termname parameter is the name of the file conta[...]

Chapter 4 283 Command Definition F-K HELLO MUST HAVE 'SM' OR 'OP' CAP. TO SPECIFY HIPRI, MAXIMUM INPRI OF 13 IS USED (CIWARN 1460) ciinfo An INFO string to be passed to the command interpreter . F or the MPE/iX CI, it is the first command to be executed by the command interpreter . This parameter replaces the ( ) COMMAND LOGON[...]

284 Chapter 4 Command Definition F-K HELLO When you first access an MPE/iX system to log on, the MPE iX: prompt is displayed. When you log off using the BYE command, the following message is displayed: CPU=1. CONNECT=1. THU, DEC 8, 1994, 1:50 PM The RELEASE: V.UU.FF number in the logon banner is determined by Hewlett-P ackard at operating system [...]

Chapter 4 285 Command Definition F-K HELLO home group as your logon group when you log on. But if you want to use some other group as your logon group, you must specify that group's name in your logon command in this way : MPE iX: HELLO USER.TECHPUBS,MYGROUP If your user name is not related to a home group, you must enter a group name in your[...]

286 Chapter 4 Command Definition F-K HELLO Example When you initially log on to access MPE/iX, the system prompt appears as: MPE iX: When you subsequently log on to another account or group, the system prompt by default is a colon (unless you have altered it with the SETVAR HPPROMPT command) and appears as: : T o start a session named ALPHA , with[...]

Chapter 4 287 Command Definition F-K HELP HELP Accesses the help subsystem (Native Mode) Syntax Direct access: HELP [{ udcname commandname [{ ke ywor d ,ALL } ] commandfilename err ormessage pr ogramfilename function name variable name SUMMARY CLASS HELPSTUDY EXPRESSIONS| V ARIABLES | OPERA TORS | FUNCTIONS } ] Interactive (subsystem) access: &g[...]

288 Chapter 4 Command Definition F-K HELP PARMS PARMS is short for parameter . Lists all parameters of the specified command. OPERATION Describes the use of the specified command. EXAMPLE Displays an example showing usage of the specified command. ALL Displays all parameters , operation information, and an example of the command. variable name [...]

Chapter 4 289 Command Definition F-K HELP Enter the HELP command without specifying any parameters to invoke HELP as a subsystem. Y ou will see the first screen of Help, called HELPMENU . It lists the choices available to you so that you can review the operation of Help and get a brief overview of the changes found in the MPE/iX operating system.[...]

290 Chapter 4 Command Definition F-K HELP Do not precede the command or item name with HELP , or you will get an error message. F or example: : HELP > HELP FINFO ^ Can't find this keyword. T o exit the Help Subsystem, enter E or EXIT ' or press Break . T o stop the display and return to a system prompt, enter CTRL Y . temporarily stop[...]

Chapter 4 291 Command Definition F-K HELP At the Help facility prompt (>), simply type the variable name, for example, "HPCIDEPTH". Global Variable Types ================================================================= R READ ONLY variable (cannot be modified). W READ/WRITE variable (can be modified). JCW A standard MPE/iX JCW. I Int[...]

292 Chapter 4 Command Definition F-K IF IF Used to control the execution sequence of a job, UDC , or command file. (Native Mode) Syntax IF expression [ THEN] P arameters expr ession Logical expression, consisting of operands and relational operators. The operators listed in T able 4-1 may be incorporated in expr ession . T able 4-1 Logical Operat[...]

Chapter 4 293 Command Definition F-K IF Operation Notes This command begins an IF block consisting of all the commands after the IF command up to, but not inc luding, the next ELSE. ELSEIF , or ENDIF statement. The ELSE, ELSEIF , or ENDIF must have the same nesting level as the IF statement. Another similar block can follow the ELSE statement. Nes[...]

294 Chapter 4 Command Definition F-K INPUT INPUT P ermits the user to assign a value interactively to any variable that could otherwise be set with the SETVAR command. The user may also create an optional prompt string and have it displayed on $STDLIST before the value is read. (Native Mode) Syntax INPUT [ NAME=] varname [ ;PROMPT= pr ompt ] [ ;W [...]

Chapter 4 295 Command Definition F-K INPUT INPUT reads a value from the standard input device ( $STDIN ) and stores it as a string in the variable named varname . If varname does not exist, INPUT creates it. If pr ompt is omitted, nothing is displayed, and INPUT waits for an input value to store in varname . The variable varname can be used as you[...]

296 Chapter 4 Command Definition F-K INPUT The first command reads whatever value you enter and sets bleep to the string representation of that input. The second command assigns bleep the (evaluated) value that you entered. INPUT MYVAR <FILEONE The above example reads the first record in FILEONE into the CI variable named MYV AR. In order to [...]

Chapter 4 297 Command Definition F-K JOB JOB Defines a job to be activated with the STREAM command or an input spooled device to run in batch mode . (Native Mode) Syntax JOB[ jobname ,] username [ / userpass ] .acctname [ / acctpass ] [ , gr oupname [ / gr ouppass ]] [TIME= cpusecs ] [;PRI= BS | CS | DS | ES] [;INPRI= inputpriority ;HIPRI] [ ;RES[...]

298 Chapter 4 Command Definition F-K JOB • Neither $STDIN nor $STDLIST is redirected. • The JOB command is a first level JOB command (it is not nested within a second level STREAM command). If the password is supplied in the command syntax it must be preceded by a slash ( / ). queuename The name of the job queue the job will execute in. The d[...]

Chapter 4 299 Command Definition F-K JOB F or information on the guidelines for these priority queues, refer to the TUNE command in this chapter . inputpriority or HIPRI Determines the input priority of the job. The inputpriority parameter is the relative input priority used in checking against access restrictions imposed by the jobfence. The inpu[...]

300 Chapter 4 Command Definition F-K JOB This parameter applies only to output destined for spooled output devices , and is ignored for other output. Default is 8. numcopies Number of copies of job listing to be produced. This parameter applies only when listing is directed to a spooled device, and is ignored in other cases . If the number of copi[...]

Chapter 4 301 Command Definition F-K JOB rather than the originating diskfile (in the case of the STREAM command) or device (in the case of the input spooled device). If the standard listing file is a line printer , MPE/iX prints a header page prior to listing the JOB command. (The system operator can disable the printing of this header page wit[...]

302 Chapter 4 Command Definition F-K JOB RUN EDITOR.PUB.SYS / ADD 1 !JOB WXYZ,WRITER.TEC 2 !EDITOR 3 TEXT ABC 4 LIST ALL,OFFLINE 5 EXIT 6 !EOJ // / KEEP MYJOB / EXIT : STREAM MYJOB The following example shows using the JOB command in interactive mode with the STREAM command: STREAM > !JOB USER.TECHPUBS;OUTCLASS=12 Related Information Commands A[...]

Chapter 4 303 Command Definition F-K JOBFENCE JOBFENCE Defines the minimum input priority that a job or session must have in order to execute . (Native Mode) Syntax JOBFENCE priorityfence P arameters priorityfence A number between 0 and 14, inclusive . Within this range , smaller numbers are less limiting; larger numbers more limiting . Operation[...]

304 Chapter 4 Command Definition F-K JOBFENCE JOBFENCE 6 16:21/#J7/34/LOGON FOR: JOB1,FIELD.SUPT ON LDEV #10 16:21/#J8/35/LOGON FOR: JOB2,FIELD.SUPT ON LDEV #10 Related Information Commands ABORTJOB , ALTJOB , BREAKJOB , JOB , SUSPENDJOB , RESUMEJOB , JOBPRI , STREAM , STREAMS , SHOWDEV Manuals Using the HP 3000 Series 900: Advanced Skills MPE/iX [...]

Chapter 4 305 Command Definition F-K JOBPRI JOBPRI Sets or changes the default execution priority for batch jobs and sets a maximum execution priority for batch jobs . (Native Mode) Syntax JOBPRI [ maxsubqueue ][, defaultsubqueue ] P arameters maxsubqueue The maximum priority at which batch jobs are allowed to run. This overrides any job priority [...]

306 Chapter 4 Command Definition F-K JOBSECURITY JOBSECURITY Designates what level of user may request resources and control the execution of jobs . (Native Mode) Syntax JOBSECURITY [ { HIGH LOW } { ;P ASSEXEMPT= { NONE} ,{ USER} ,{ XACCESS} ,{ MAX} } ] P arameters HIGH P ermits only the operator logged on at the console and users with SM capabili[...]

Chapter 4 307 Command Definition F-K JOBSECURITY it is set to LOW , any user may issue these commands for their own jobs (i.e., those where the job's user name and account matches the user's) and Account Managers may control the execution of any job in their account. System managers may use the P ASSEXEMPT parameter of the JOBSECURITY co[...]

308 Chapter 4 Command Definition F-K JOBSECURITY If the HP Security Monitor is installed with both stream privilege and authorization turned on, the JOBSECURITY command will display a warning when the output produces a different result. : JOBSECURITY ;PASSEXEMPT=USER Security Monitor is installed. Passexempt is MAX. (CIWARN 3128) Related Informati[...]

Chapter 4 309 Command Definition F-K LDISMOUNT LDISMOUNT Cancels a previously issued LMOUNT or VSRESERVE command. This informs the system that the volume set is no longer reserved system-wide. The equivalent native mode command is VSRELEASESYS . (Native Mode) Syntax LDISMOUNT [ { * | | volumesetname }][, gr oupname [. acctname ]] P arameters * or [...]

310 Chapter 4 Command Definition F-K LDISMOUNT In MPE V/E, the name V.G.A indicates that V is the name of a volume set, that G is the name of a group, and that A is the name of an account. MPE/iX accepts that name in that form, but no interpretation is made as to the referencing of G and A . Instead, MPE/iX accepts that name in that form, but no i[...]

Chapter 4 311 Command Definition F-K LDISMOUNT Related Information Commands MOUNT , , LMOUNT , DISMOUNT , DSTAT , VSRESERVE , VSRELEASE Manuals V olume Management Reference Manual[...]

312 Chapter 4 Command Definition F-K LIMIT LIMIT Limits the number of concurrently running jobs/sessions . (Native Mode) Syntax LIMIT[ { [+ | - ] numberjobs [+ | - ] , numbersessions | numberjobs,numbersessions ] [;JOBQ=queuename] P arameters + Increment the limit value - Decrement the limit value numberjobs The number of jobs . number - sessions [...]

Chapter 4 313 Command Definition F-K LIMIT Use This command may be issued from a session, job , program, or in BREAK. Pressing Break has no effect on this command. It may be issued only from the console unless distributed to users with the ALLOW command. Examples T o limit the number of jobs to 2 and the number of sessions to 15, enter: LIMIT 2,15[...]

314 Chapter 4 Command Definition F-K LINK LINK Creates an executable program file by merging the relocatable object modules from all the files in its FROM= parameter . Those files may correspond to object files, relocatable files , or a combination of them. It also searches any relocatable libraries mentioned in the RL= parameter list and mer[...]

Chapter 4 315 Command Definition F-K LINK If a module from one library calls a routine in another library and then that routine in turn refers to a module in the first library , you may need to include the first library twice so that LINK can resolve this “circular“ reference. The FROM= , RL= , and XL= parameters allow a series of file name[...]

316 Chapter 4 Command Definition F-K LINK T able 4-4 Checklevel V alues entryname The name (label) of the point within a program where execution begins . When you omit this parameter , the loader begins execution from the primary program entry point (which corresponds to a program's main procedure or outer block). However , by including the E[...]

Chapter 4 317 Command Definition F-K LINK SHARE Specifies that data symbols should be exportable and importable (shared) in the resulting executable library . Operation Notes The Link Editor uses $STDINX , $STDIN , and $STDLIST as standard files. The Link Editor reads its commands from $STDINX . F or interactive sessions this is the terminal key[...]

318 Chapter 4 Command Definition F-K LINK Use This command may be issued from a session, job , or program, but not in BREAK. Pressing Break suspends the execution of this command. Entering the RESUME command continues the execution. Examples This command merges the object modules from the OBJCODE and places them into the program EXECPROG . It assi[...]

Chapter 4 319 Command Definition F-K LIST A CCT LIST ACCT Displays information about one or more accounts . Syntax LISTACCT [ acctset ][, listfile ] [ ;P ASS] [ ;FORMAT={ SUMMARY|BRIEF|DET AIL} ] P arameters acctset The accounts to be listed. The default is all accounts for system managers (SM). F or all other users, the default is their logon ac[...]

320 Chapter 4 Command Definition F-K LIST A CCT Examples The presence of the password in the following display implies that the user has account manager (AM) capability and this is the user's account, or that the user has system manager (SM) capability and this is not the user's account. LISTACCT HPXLII;PASS ...or... LISTACCT HPXLII;PASS[...]

Chapter 4 321 Command Definition F-K LISTDIR (UDC) LISTDIR (UDC) The LISTDIR UDC executes the LISTFILE command to list all files that are directories. System-defined UDCs are not automatically available . Y our System Manager must use the SETCATALOG command to make these UDCs available for your use . F or example, SETCATALOG HPPXUDC.PUB.SYS;SYST[...]

322 Chapter 4 Command Definition F-K LISTDIR (UDC) Related Information Commands LISTFILE , FINDDIR (UDC) Manuals None[...]

Chapter 4 323 Command Definition F-K LISTEQ LISTEQ Displays all active file equations for a job or session. Syntax LISTEQ [ listfile ] P arameters listfile The name of the output file. The default is $STDLIST , a temporary file that cannot be overwritten by a BUILD command. It is automatically specified as a new ASCII file with variable-len[...]

324 Chapter 4 Command Definition F-K LISTF LISTF Displays information about one or more permanent files . (CM) Syntax LISTF [ fileset] [ ,listlevel] [ ;listfile] P arameters fileset Specifies the set of files to be listed. The default is @ , which lists all files in your logon group. Y ou may select the file(s) to be listed by using the fu[...]

Chapter 4 325 Command Definition F-K LISTF 2 Displays the file name , file code, record size, file type , current end-of-file location, and the maximum number of records allowed in the file. It also displa ys the blocking factor , number of sectors in use, number of extents currently allocated, and the maximum number of extents allowed. 3 −[...]

326 Chapter 4 Command Definition F-K LISTF listfile The name of the output file to which the file information will be written. If you omit this parameter , the output appears on $STDLIST . If you specify listfile , the output is sent to a temporary file created for this purpose. The temporary file is a new ASCII file with variable length re[...]

Chapter 4 327 Command Definition F-K LISTF Y ou may have the information displa yed on a device other than the standard listing device. T o do that, you will need to name the device with a FILE command and then backreference the file in the LISTF command. F or example: : FILE PRTR;DEV=LP : LISTF @.@,2;*PRTR Use The LISTF command is available from[...]

328 Chapter 4 Command Definition F-K LISTF DISC DEV # 3 ACCESSED FRI, 21 SEP 1986, 12:46 PM CLASS DISC LABEL ADDR ** SEC OFFSET 0 VOLSET MPEXL_SYSTEM_VOLUME_SET or VOLNAME MPEXL_SYSTEM_VOLUME_SET: MEMBER1 or VOLCLASS MPEXL_SYSTEM_VOLUME_SET: DISC CLASS : DISC LABEL ADDR: $00000010 $0010E014 Level 6 File Display : LISTF L@,6 LINKCLK.DEVELOP.HPXLII [...]

Chapter 4 329 Command Definition F-K LISTF ACCESS: R-excl REC#: 336 FNUM: 15 LOCKSOwner Waiter OPEN FLOCK Level -2 File Display FILENAME ACD ENTRIES DOCMNTS NO ACDS Level -3 File Display : LISTF DOCMNTS,-3 ******************** FILE DOCMNTS.DEVELOP.HPXLII FCODE O FOPTIOc NS STD,ASCII,FIXED,NOCCTL 15496000 BLK FACTOR 16 CREATOR PETE REC SIZE 80(BYTE[...]

330 Chapter 4 Command Definition F-K LISTF 00010405 00000000 00000300 00020CEE 0EA78B32 00020CEE .......H........ 0EA78B32 00020CEE 12F61E2D 00020CEE 0EA78B32 00000000 ................ 000000A0 000001F5 00000000 00000000 00000000 00000000 ........... .. 00009C90 00000000 00000000 00000000 00000050 00000500 ................ 00100000 00190007 000F00[...]

Chapter 5 331 Command Definitions L-O 5 Command Definitions L-O[...]

332 Chapter 5 Command Definitions L-O LISTFILE LISTFILE This command lists file and directory attributes through the use of options . The LISTFILE information is a superset of the LISTF command information. Syntax LISTFILE [[ fileset =] { fileset ( fileset [, fileset ] ...) } ] [ [ ;FORMAT=] format_opt ] [ [ ;SELEQ=] select_eq | ^ indir ] [ [[...]

Chapter 5 333 Command Definitions L-O LISTFILE F or example, "[a-c]" means one of ‘a', ‘b', or ‘c', whereas "[-a-c]" or "[a-c-]" means one of ‘a', ‘b', ‘c', or ‘-'. It is illegal to specify [c-a], or [a-A] because ‘c' does not alphabetically precede ‘a' an[...]

334 Chapter 5 Command Definitions L-O LISTFILE If fileset ends in a slash, it is treated as a directory name, and pattern is used to determine the file names that match. All the directories and files that match fileset are found, and searched recursively to display the files and directories that match pattern . F or example, if fileset is /S[...]

Chapter 5 335 Command Definitions L-O LISTFILE 1 SUMMARY Displays the file name, file code , record size, record format, and other file characteristics such as ASCII or binary records , carriage-control option, file type, current end-of-file location, and the maximum number of records allowed in the file. 2 DISC Displays the file name , fi[...]

336 Chapter 5 Command Definitions L-O LISTFILE select_eq A selection equation. Use the selection equation as a filter on fileset . From the set of files matching the fileset, only files that match the select_eq requirements are listed. Y ou may select file types by using the FTYPE option, or you may select object types by using the OBJECT op[...]

Chapter 5 337 Command Definitions L-O LISTFILE MNEMONIC List only files matching the specified file code mnemonic PRIV List only files with negative file code. INUSE Lists only files that are currently in use by users or by MPE. OPEN Lists only files that are opened by progams . INUSE is a superset of OPEN . LOCK List only files being lock[...]

338 Chapter 5 Command Definitions L-O LISTFILE the files at the specified level are displayed. F or example, /@/@/@ indicates that all objects at the third level are to be displayed. USENAME is the default. TREE If the TREE option is specified, objects at all lower directory levels are displayed. NOTREE Indicates that only objects at the speci?[...]

Chapter 5 339 Command Definitions L-O LISTFILE FILENAME CODE LOGICAL RECORD- SPACE SIZE TYP EOF LIMIT R/B SECTORS #X MX F4 80B AF 411 411 16 144 2 * F5 80B AF 199 199 16 64 1 * HFS Examples The following figure illustrates a hierarchical directory structure . In this figure, directory names are shown as the character d plus a number (for example[...]

340 Chapter 5 Command Definitions L-O LISTFILE In the next example, specifying the absolute pathname produces a listing of all entries one level below the group. /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/ In the next example, [...]

Chapter 5 341 Command Definitions L-O LISTFILE The next example illustrates the use of the OBJECT=DIR parameter to show all directories on the system. This is similar to the FINDDIR UDC. /ACCT/GROUP/d0: listfile /, qualify;seleq=[object=dir];format=qualify / /ACCT/ /ACCT/GROUP/ /ACCT/GROUP/d0/ /ACCT/GROUP/d0/d1/ /ACCT/GROUP/d0/d2/ /ACCT/GROUP/d0/d[...]

342 Chapter 5 Command Definitions L-O LISTFILE NUM EXT: 2 EXECUTE : MAX REC: 67107839 **SECURITY IS ON FLAGS : NO ACCESSORS NUM LABELS: 0 CREATED : TUE, JUL 21, 1992, 2:20 PM MAX LABELS: 0 MODIFIED: TUE, JUL 21, 1992, 2:23 PM DISC DEV #: 1 ACCESSED: WED, JUL 22, 1992, 12:05 PM SEC OFFSET: 0 LABEL ADDR: ** VOLCLASS : MPEXL_SYSTEM_VOLUME_SET:DISC **[...]

Chapter 5 343 Command Definitions L-O LISTFILE LOCK : EXECUTE : GROUP READ : WRITE : APPEND : LOCK : EXECUTE : SAVE : FILE - READ : FCODE: 0 WRITE : **SECURITY IS ON APPEND : ACD EXISTS LOCK : EXECUTE : FOR MANAGER.ACCT: RACD, TD, RD, CD, DD The next example illustrates the use of the FORMAT=-2 (ACD) option to display the access contol definition[...]

344 Chapter 5 Command Definitions L-O LISTFTEMP LISTFTEMP Displays information about one or more temporary files . Syntax LISTFTEMP [ fileset ][, listlevel ][; listfile ] P arameters fileset Specifies the set of temporary files to be listed. The default is @ , producing a listing of all temporary files . Y ou may select the temporary file([...]

Chapter 5 345 Command Definitions L-O LISTFTEMP SECTORS The number of sectors allocated for the file on disk. This number is alw ays a multiple of 16 (the page size in MPE/iX). This value is an indication of the size of the file. #X Number of extents . This number is displayed only to maintain compatibility with MPE V/E. This value does not indi[...]

346 Chapter 5 Command Definitions L-O LISTFTEMP listfile The name of the output file. The default is $STDLIST . If you specify listfile , it is automatically created as a new ASCII file with variable-length records , closed in the temporary domain, and with user -supplied carriage-control characters ( CCTL ), OUT access mode , and EXC (EXCLUSI[...]

Chapter 5 347 Command Definitions L-O LISTFTEMP BLK FACTOR: 16 CREATOR: REC SIZE: 80(BYTES) LOCKWORD: BLK SIZE: 640(BYTES) SECURITYREAD :ANY EXT SIZE: 25(SECT) WRITE :ANY NUM REC: 501 APPEND :ANY NUM SEC: 165 LOCK :ANY NUM EXT: 7 EXECUTE:ANY MAX RED: 501 **SECURITY IS ON MAX EXT: 7 FLAGS: n/a NUM LABELS: 0 CREATED: FRI, 21 SEP 1986, 11:55 AM MAX L[...]

348 Chapter 5 Command Definitions L-O LISTGROUP LISTGROUP Displays information for one or more groups . Syntax LISTGROUP [ gr oupset ][, listfile ] [ ;P ASS] [ ;FORMAT={ SUMMARY|BRIEF|} ] P arameters gr oupset Specifies the set of groups to be listed. F or account managers (AM) and system managers (SM), the default is all ( @ ) groups within the[...]

Chapter 5 349 Command Definitions L-O LISTGROUP Example In the following example, since the user does not ha ve AM or SM capability , the password does not appear in the display . LISTGROUP DEVELOP;PASS;FORMAT=SUMMARY ******************* GROUP: DEVELOP.TEST DISC SPACE: 5752(SECTORS) PASSWORD: ** CPU TIME : 0(SECONDS) SECURITYREAD : GU CONNECT TIME[...]

350 Chapter 5 Command Definitions L-O LISTJOBQ LISTJOBQ LISTJOBQ lists all available job queues in the system. Syntax LISTJOBQ P arameters none Operation Notes The LISTJOBQ command allows the user to list all the existing job queues in the system. It displays the queue name , limit, number of jobs in the queue that are in the EXEC state and the to[...]

Chapter 5 351 Command Definitions L-O LISTLOG LISTLOG Lists currently active logging identifiers on the system and whether automatic log file changing has been enabled. Syntax LISTLOG [ logid [ ;P ASS] ] P arameters logid The specific logging identifier to be verified. Default is to list all currently active logging identifiers on the system[...]

352 Chapter 5 Command Definitions L-O LISTLOG Related Information Commands ALTLOG , CHANGELOG , GETLOG , LOG , OPENLOG , SHOWLOGSTATUS , RELLOG Manuals User Logging Programmer's Guide (32650-60012)[...]

Chapter 5 353 Command Definitions L-O LISTREDO LISTREDO Displays the contents of the command line history stack. Y ou may specify the format in which the listing appears , and whether it appears on $STDLIST or in a file. (Native Mode) Syntax LISTREDO [ START= m ] [ ;END= n ] [ ;OUT= outfile ] [ ;{ ABS REL UNN } ] NO TE This command follows the o[...]

354 Chapter 5 Command Definitions L-O LISTREDO UNN Suppresses numbering of the commands during display . outfile Sends the listing to a disk file named outfile instead of to the default, $STDLIST . New disk files are created TEMP . File equations are ignored, unless outfile is preceded by an asterisk ( * ). Y ou must use a file equation to o[...]

Chapter 5 355 Command Definitions L-O LISTSPF LISTSPF Produces a listing of input and output spooled files . (Native Mode) Syntax LISTSPF [ [ IDNAME=] { spoolid ( spoolid [, spoolid ]. . . )}][[ ;SELEQ=] { select-eq ^ indir ect_file } ] [ ;DETAIL ;ST ATUS ] NO TE This command follows the optional MPE/iX command line syntax. Refer to "Option[...]

356 Chapter 5 Command Definitions L-O LISTSPF If you are not an SM, OP , AM, or console user , the following command displays all the output files in your default group with a priority greater than 2 that were created before September 30, 1994. LISTSPF O@;SELEQ=[(PRI>2)AND(DATE<09/30/94)] Selection equations have the following format. The s[...]

Chapter 5 357 Command Definitions L-O LISTSPF • parm ::= PAGES : Number of pages in the spool file (if known). A positive integer number is expected. This attribute does not apply to input spool files; therefore, any logical condition involving the attribute alwa ys returns F ALSE when tested against an input spool file. • parm:= FORMID : F[...]

358 Chapter 5 Command Definitions L-O LISTSPF Y ou may use some wildcards; J@ accepts all jobs , S@ accepts all sessions . J'@ and S'@ are also allowed, The apostrophe (') indicates an imported spool file or a spool file recovered during START NORECOVERY . • parm ::= RECS : Number of records in the spool file. A positive intege[...]

Chapter 5 359 Command Definitions L-O LISTSPF • This process repeats until either 509 characters have been counted or the end-of-file is detected. Records terminating with or without ampersands may be mixed as desired in the indirect file . • If the resulting string is ≤ 509 characters, it is parsed. • If the parser detects a syntax erro[...]

360 Chapter 5 Command Definitions L-O LISTSPF Display F ield and Description Below is an example of the first line of the display for LISTSPF . F ollowing the example is a description of each field in the display . SPOOLID JOBNUM FILEDES PRI COPIES DEV STATE RSPFN OWNER #01 J12345 $STDLIST 6 1 EPOC CREATE RSPFN THISUSER.ACCOUNT1 SPOOLID The uniq[...]

Chapter 5 361 Command Definitions L-O LISTSPF before printing the trailer of its current one. (This is required to manage headers and trailers properly). Also note that you see only one file in the PRINT state during a trailer if the next file is another copy of the current file. • DEFER : An output spool file is in the deferred state. • S[...]

362 Chapter 5 Command Definitions L-O LISTSPF OWNER This is the fully qualified name of the creator of the spool file. Below is an example of the optional second line of the display , followed by an explantion of each display field. FORMID JOBNAME COPSRM SECTS RECS PAGES DATE TIME TESTJOB 1 250 500 ~9 12/20/88 8:39 FORMID An 8-character display[...]

Chapter 5 363 Command Definitions L-O LISTSPF • The itemized count of spool files in each of the various states . They are shown in two groups , input spool files to the left of the display and output spool files to the right. Of these, only SELECTED is not a state. Instead, SELECTED shows the total count of spool files whose output priority[...]

364 Chapter 5 Command Definitions L-O LISTSPF #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 = 0; SPSAVE = 0; PRINT = 1;[...]

Chapter 5 365 Command Definitions L-O LISTUSER LISTUSER Displays information for one or more users . Syntax LISTUSER [ userset ][, listfile ] [ ;P ASS] [ ;FORMAT={ SUMMARY|BRIEF|DET AIL} ] P arameters userset Specifies the set of users to be listed. The default is all ( @ ) users (and accounts) within the user's capabilities (AM or SM). Use[...]

366 Chapter 5 Command Definitions L-O LISTUSER LISTUSER PETE;PASS ...or... LISTUSER PETE;PASS;FORMAT=SUMMARY ******************* USER: PETE.TEST 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 LISTUSER @;FORMAT=BRIEF PETE.TEST MIKE.TEST CHRIS.TEST [...]

Chapter 5 367 Command Definitions L-O LMOUNT LMOUNT Requests a logical reservation of a volume set. This informs the system that the volume set is to be reserved system-wide. The equivalent native mode command is VSRESERVESYS . (Native Mode) Syntax LMOUNT [{ * volumesetname }][. gr oupname [. acctname ] ] [ ;GEN=[ genindex ]] NO TE F or the MOUNT [...]

368 Chapter 5 Command Definitions L-O LMOUNT If the mountable volumes facility was enabled with VMOUNT ON,AUTO , MPE/iX automatically attempts to satisfy the mount request; the LMOUNT succeeds if the specified volume set is physically connected to the system. If the mountable volumes facility was enabled with VMOUNT ON (omitting the AUTO paramete[...]

Chapter 5 369 Command Definitions L-O LMOUNT However , VSRESERVE V succeeds only if there is a volume set V in existence. The MPE/iX commands does not call up any default specifications for group and account. VSRESERVE V.G.A succeeds only if a volumeset V.G.A is online. With MPE/iX VSxxxxxx commands, the .G.A component of this name is interpreted[...]

370 Chapter 5 Command Definitions L-O LOG LOG Starts , restarts, or stops user logging . Syntax LOG logid { ,RESTART ,ST ART ,STOP } P arameters logid Logging identifier previously established with a user GETLOG command. START Initiates a logging process . RESTART Restarts a logging process . STOP T erminates a logging process. Operation Notes Th[...]

Chapter 5 371 Command Definitions L-O =LOGOFF =LOGOFF Aborts all executing jobs/sessions and prevents any further logons . Y ou may optionally specify one job or one session that is to remain logged on. Syntax =LOGOFF [# S nnn ] or =LOGOFF [# J nnn ] P arameters # S nnn or # J nnn The number of the session or the job that is to remain logged on af[...]

372 Chapter 5 Command Definitions L-O =LOGOFF CTRL A = LOGOFF #S1 = LOGON LIMIT 0,0 JOBFENCE 0 This logs off all users except #S1 and allows only users with system manager (SM) and system supervisor (OP) capability to log on. It is assumed here that the console operator controls #S1 . Related Information Commands =LOGON , ABORTJOB , TELL , WARN Ma[...]

Chapter 5 373 Command Definitions L-O =LOGON =LOGON Enables job/session processing following a =LOGOFF command. Syntax =LOGON P arameters None. Operation Notes This command enables the processing of jobs/sessions following the execution of the =LOGOFF command. The =LOGON command reestablishes the job/session limits that were in effect before the e[...]

374 Chapter 5 Command Definitions L-O MOUNT MOUNT Sends a request to the system to reserve a volume set (keep it online). The set must be online in order to have the command take effect. (Native Mode) Syntax MOUNT [{ * volumesetname }][. gr oupname [. acctname ] ] [ ;GEN=[ genindex ]] P arameters * or <blank> Specifies the home volume set f[...]

Chapter 5 375 Command Definitions L-O MOUNT T able 5-5 Command Acceptance of Naming Conventions - MOUNT Command In MPE V/E, the name V.G.A indicates that V is the name of a volume set, that G is the name of a group, and that A is the name of an account. MPE/iX accepts that name in that form, but no interpretation is made as to the referencing of G[...]

376 Chapter 5 Command Definitions L-O MOUNT It is recommended that you not use the MPE V/E naming convention and xxxMOUNT commands . Instead use the MPE/iX naming convention and VSxxxxxx commands. Alternating between MPE V/E and MPE/iX commands may lead to errors . F or example, MOUNT X used in a job stream attempts to access a volume set named X.[...]

Chapter 5 377 Command Definitions L-O NEW A CCT NEW ACCT Creates a new account with an associated account manager and PUB group. Syntax NEWACCT acctname , mgrname [ ;P ASS=[ passwor d ] ] [ ;FILES=[ filespace ] ] [ ;CPU=[ cpu ] ] [ ;CON NECT=[ connect ]][; C AP=[ capabilitylist ] ] [ ;ACCESS=[ fileaccess ] ] [ ;MAXPRI=[ subq ueuename ] ] [ ;LOCA[...]

378 Chapter 5 Command Definitions L-O NEW A CCT cpu Limit on total CPU-time, in seconds , for this account. This limit is c hecked only when a job or session is initiated, and so the limit never causes the job or session to abort. The maximum value you may define with NEWACCT is 2,147,483,647 seconds . Default is that no limit is assigned. connec[...]

Chapter 5 379 Command Definitions L-O NEW A CCT The default is no security restrictions at the account level. Two or more user types may be specified if they are separated by commas . subqueuename The name of the subqueue of highest priority that can be requested by any process of any job/session in the account. This parameter is specified as AS[...]

380 Chapter 5 Command Definitions L-O NEW A CCT OPT Specifies that users of the account may or may not ha ve passwords . This is the default. It is available only if the HP Security Monitor has been installed. Operation Notes The NEWACCT command may be executed only by the System Manager . The System Manager is responsible for establishing the ac[...]

Chapter 5 381 Command Definitions L-O NEW A CCT The second command connects the accounting structures established on the system volume and on the volume set. By default, however , the PUB group of this account is on the system volume set. T o place the PUB group on the volume set MY_VOL , you need to use the PUB parameter in the first command: NE[...]

382 Chapter 5 Command Definitions L-O NEWDIR NEWDIR Creates a directory . (Native Mode) Syntax NEWDIR [ DIR=] dir_name [ ;SHOW | NOSHOW] P arameters dir_name The name of the directory that you are creating (required). The dir_name is assumed to be an MPE name unless it begins with a a dot (.) or a slash (/), which indicates an HFS directory . The [...]

Chapter 5 383 Command Definitions L-O NEWDIR Examples In the following two examples , a user creates a directory called DIR1 . In the first example, the full pathname of the directory is specified in all uppercase since HFS syntax is case-sensitive. In the second example , the user enters the information in lower case using the MPE syntax dir_na[...]

384 Chapter 5 Command Definitions L-O NEWGROUP NEWGROUP Creates a new group within an account. Syntax NEWGROUP gr oupname [. acctname ] [ ;P ASS=[ password ] ] [ ;FILES=[ filespace ] ] [ ;CPU= [ cpu ] ] [ ;CONNECT=[ connect ] ] [ ;CAP=[ capabilitylist ] ] [ ;ACCESS=[ ( fileaccess ) ]][ ;ONVS= volumesetname ] [ ;HOMEVS= volumesetname ] P arameter[...]

Chapter 5 385 Command Definitions L-O NEWGROUP connect The limit on the total cumulative session connect-time, in minutes , that the group is allowed. This limit is checked at logon and whenever the session initiates a new process . The maximum value you ma y specify with this command is 2,147,483,647 minutes . Default is the account connect limit[...]

386 Chapter 5 Command Definitions L-O NEWGROUP ONVS Specifies a particular volume set on which the group is to be built. The volume set must be already defined and recognized by the system. The NEWGROUP command must be specified twice before files can be created in this group on a mountable volume set. The first NEWGROUP builds the group on t[...]

Chapter 5 387 Command Definitions L-O NEWGROUP NEWGROUP GROUP1 T o create a new group named G2 in the account GRIMSBY (on the system volume set) and give it process handling (PH) and multiple RINs (MR) capabilities , enter: NEWGROUP G2.GRIMSBY; CAP=PH,MR T o create the group LEELA on the nonsystem volume set TIME_LORD , you must use two parallel c[...]

388 Chapter 5 Command Definitions L-O NEWJOBQ NEWJOBQ The NEWJOBQ command creates a new job queue. Syntax NEWJOBQ qname [;limit=n] P arameters qname Name of the queue to be created. If a queue of this name already exists , an error is indicated. limit Maximum number of jobs that can be allowed in this queue. The limit value can be changed using th[...]

Chapter 5 389 Command Definitions L-O NEWLINK NEWLINK Creates a link to a file, group , account, or directory . (Native Mode) Syntax NEWLINK [ LINK=] linkname [ ;TO=] sour ceobject [ { ;SYMBOLIC} ] P arameters linkname The pathname that points to the file, that when created, will contain the link. linkname must resolve to a unique name. It ma y [...]

390 Chapter 5 Command Definitions L-O NEWLINK T able 5-7 CI Commands Affected by Symbolic Links Y ou can issue the NEWLINK command from a session, job, program, or in BREAK. NEWLINK requires Save Files (SF) capability , Create Directory entry (CD) and Traverse Directory (TD) permissions . Command Name F ollow Link Notes CHGROUP No None DISKUSE Y e[...]

Chapter 5 391 Command Definitions L-O NEWLINK Examples The following tree structure will be used to construct the examples that follow it. Assume that the CWD is /ACCT1/PUB . ROOT |- | | | ACCT1 dir SOFTWARE | / | - f1 f2 | | | | PUB dir1 PUB CODE | / | | - file1 file2 ACCTORG - | | | | | | ACCTUDC FILE3 COMMON TERMIO COMPALL dir2 / | f1 f2 [...]

392 Chapter 5 Command Definitions L-O NEWLINK The following command creates FILE3 as a symbolic link to the nonexistent file SOURCE1.CODE.SOFTW ARE. : NEWLINK LINK=FILE3.PUB.ACCT1; TO=SOURCE1.CODE.SOFTWARE The following command creates a symbolic link FILE4 as a link to an existing file. : NEWLINK LINK=FILE4.PUB.ACCT1; TO=/SOFTWARE/CODE/dir2/f1 [...]

Chapter 5 393 Command Definitions L-O NEWUSER NEWUSER Creates a new user . Syntax NEWUSER username [. acctname ] [ ;P ASS=[ passwor d ] ] [ ;CAP=[ capabilitylist ] ] [ ;MAXPRI=[ subque uename ] ] [ ;LOCA TTR=[ localattribute ] ] [ ;HOME=[ home gr oupname ] ] [ ;UID=[ uid ]][ ;USERP ASS=[ { REQ OPT } ] [ Expir ed ]] The USERP ASS parameter is only [...]

394 Chapter 5 Command Definitions L-O NEWUSER subqueuename The name of the highest-priority subqueue that any job or session in the account can request for executing processes . The subqueuename may be either AS , BS , CS , DS , or ES . The priority specified for the user in NEWUSER cannot be greater than that specified for the account. The subq[...]

Chapter 5 395 Command Definitions L-O NEWUSER T able 5-8 User Capabilities Use This command may be issued from a session, a job , a program, or in BREAK. Pressing Break has no effect on this command. Account manager (AM) or system manager (SM) capability is required to execute this command. Examples T o define a new user named LHSMITH , assign a [...]

396 Chapter 5 Command Definitions L-O NEWUSER T o define a new user named LHSMITH , assign a passwor d of SMITTY , a home group of HOMEGPX , and assign a UID of 120, enter: NEWUSER LHSMITH;UID=120;PASS=SMITTY;HOME=HOMEGPX Related Information Commands ALTUSER , LISTUSER , NEWACCT , NEWGROUP , PURGEUSER Manuals P erforming System Management T asks [...]

Chapter 5 397 Command Definitions L-O NSCONTROL NSCONTROL Controls the Network Service subsystem. Syntax NSCONTROL function [ ;function] ... function may be START= [ service [, service ] ...] ST OP= [ service [, service ] ...] ABORT AUTOLOGON= [ { ON OFF } ] [ { ,ALL [ , service [, service ] ] } ] LOADKEYS LOG= [ { ON OFF } ] [ ,ALL ,RPM ,ENV ,DSD[...]

398 Chapter 5 Command Definitions L-O NSCONTROL RFAL Enables local users to access files and data bases on remote nodes . RPM Enables remote users to create and kill processes on the local node using the Remote Process Management (RPM) service. RPML Enables local users to create and kill processes on the local and remote nodes using the Remote Pr[...]

Chapter 5 399 Command Definitions L-O NSCONTROL ENV LOW Logs environment information from DSLINE and REMOTE HELLO commands . ENV HIGH Same as LOW , plus environment table locking and use counts. DSDAD LOW Logs creation and deletion of sockets , ports, and server processes . DSDAD HIGH Same as LOW , plus all received service requests and internal m[...]

400 Chapter 5 Command Definitions L-O NSCONTROL NO TE The total number of all active servers may not exceed 1250. The sum of all minservers must alwa ys be 1250 or less. Y ou may specify a number greater than 1250 as one or more maxservers values , but there will never be more than a total of 1250 servers of all kinds at any one time. STATUS Displ[...]

Chapter 5 401 Command Definitions L-O NSCONTROL NSCONTROL SERVER Alters the characteristics of the Network Service processes . NSCONTROL STATUS Displays information about the Network Services . NSCONTROL VERSION Displays the overall version of the Network Services subsystem, and optionally the version of each of its modules . Examples Start the tr[...]

402 Chapter 5 Command Definitions L-O OCTCOMP OCTCOMP Converts a compiled MPE V/E program into native mode (NM) code for the HP 3000 Series 900. (Native Mode) CA UTION Before using this command be sure your logon group and account does not contain files of the form Yn, Ynn or Ynnn where n is any alphanumeric character . OCTCO MP may create tempor[...]

Chapter 5 403 Command Definitions L-O OCTCOMP add=se glist [;] Add translated segments to the file named in the command string . Note that the named file may already contain translated code. When you specify this option, OCTCOMP replaces already translated segments . If you use the add option, the targ etfile , ignor e , and trans parameters ar[...]

404 Chapter 5 Command Definitions L-O OCTCOMP or 0 .. 7 - Octal or $0 .. F - Hexadecimal or A[..] .. Z[..] - Alpha (SL only) * or ^ filename (an indirect file) ** * In this form, a segnum identifier may consist of as many as 16 characters , beginning with an alphabetic character . ** Y ou must number indirect files , and you cannot nest them. [...]

Chapter 5 405 Command Definitions L-O OCTCOMP Examples The following set of examples illustrates the use of the add= , ignore= , and trans= parameters and the effect each of them has on the content of the translated code output file with each succeeding invocation of OCTCOMP . In each example, the input file is assumed to consist of seven segmen[...]

406 Chapter 5 Command Definitions L-O OPENQ OPENQ Opens the spool queue(s) for a specified logical device, or device name or all device members of a device class . (Native Mode) Syntax OPENQ { ldev [ ;SHOW] devclass [ ;SHOW] devname [ ;SHOW] @ } P arameters ldev The logical device number of the device . devclass The device class name of the devic[...]

Chapter 5 407 Command Definitions L-O OPENQ Use This command may be issued from a session, job , program, or in BREAK. Pressing Break has no effect on this command. It may be executed only from the console unless distributed to users with the ALLOW or ASSOCIATE command. Example T o open the spool queue for logical device 6, enter: OPENQ 6 T o show[...]

408 Chapter 5 Command Definitions L-O OPTION OPTION Modifies the runtime environment of user -defined commands and command files . It is used within the body of a user command to set up and change the environment dynamically . (Native Mode) NO TE Be sure to distinguish between the OPTION command and OPTION used in the header of a user command. [...]

Chapter 5 409 Command Definitions L-O OPTION The LIST/NOLIST option specifies whether command lines in a UDC are printed before execution of each command. RECURSION/ NORECURSION determines the search order for commands cataloged. RECURSION starts the UDC search at the beginning of the cataloged commands . NORECURSION , the default setting , start[...]

410 Chapter 5 Command Definitions L-O OUTFENCE OUTFENCE Defines the minimum priority that an output spoolfile needs in order to be printed. (Native Mode) Syntax OUTFENCE outputpriority [ ;LDEV= ldev ] [ ;DEV= { ldev de vclass devname }] P arameter outputpriority A number between 1 and 14, inclusive . A larger number is more limiting. ldev The lo[...]

Chapter 5 411 Command Definitions L-O OUTFENCE Examples T o defer all output spoolfiles except those waiting to be printed by LDEV 6, which is usually configured as the system line printer , set the global outfence to 14 and the outfence of LDEV 6 to 7, as shown below: OUTFENCE 14 OUTFENCE 7;LDEV=6 T o display the new global outputpriority and t[...]

412 Chapter 5 Command Definitions L-O OUTFENCE[...]

Chapter 6 413 Command Definitions P-R 6 Command Definitions P-R[...]

414 Chapter 6 Command Definitions P-R P ASCAL P ASCAL Compiles a compatibility mode P ascal/V program. P ascal/V is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purc hased separately . The native mode equivalent of this command is PASXL . Syntax PASCAL [ textfile ][, [ uslfile ][, listfile ] ] [ [...]

Chapter 6 415 Command Definitions P-R P ASCAL Operation Notes The PASCAL command compiles a compatibility mode P ascal/V program and stores the object code in a user subprogram library (USL) file on disk. If textfile is not specified, MPE/iX expects the source program to be entered from your standard input device. If you do not specify listfil[...]

416 Chapter 6 Command Definitions P-R P ASCALGO P ASCALGO Compiles , prepares, and executes a compatibility mode P ascal/V program. Pascal/V is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately . The native mode equivalent of this command is PASXLGO . Syntax PASCALGO [ textfile ][, [...]

Chapter 6 417 Command Definitions P-R P ASCALGO The USL file created during the compilation is the system-defined temporary file $OLDPASS , which is passed directly to the MPE segmenter . It can only be accessed if you do not use the default for pro gfile . This is because the segmenter also uses $OLDPASS to store the prepared program segments[...]

418 Chapter 6 Command Definitions P-R P ASCALPREP P ASCALPREP Compiles and prepares a compatibility mode P ascal/V program. P ascal/V is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately . The native mode equivalent of this command is PASXLLK . Syntax PASCALPREP [ textfile ][, pr og[...]

Chapter 6 419 Command Definitions P-R P ASCALPREP initial compiler options to a program. P ascal/V brackets the quotedstring with dollar signs and places it before the first line of source code in the text file. Operation Notes The PASCALPREP command compiles and prepares a compatibility mode P ascal/V program into a program file on disk. If yo[...]

420 Chapter 6 Command Definitions P-R P ASSWORD P ASSWORD Creates or changes a user password. (Native Mode) Syntax PASSWORD P arameters None. Use This command may be issued from a session or in BREAK. It is breakable (aborts execution). It cannot be used if $STDIN or $STDLIST are redirected. Operation This command allows users to establish or chan[...]

Chapter 6 421 Command Definitions P-R P ASXL P ASXL Compiles an HP P ascal/iX program. HP P ascal/iX is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purc hased separately . (Native Mode) Syntax PASXL [ textfile ][, [ objectfile ][, [ listfile ][, libfile ] ] ] [ ;INFO= quotedstring ] P arameters[...]

422 Chapter 6 Command Definitions P-R P ASXL If listfile is $NULL or a file other than $STDLIST , the compiler displays on $STDLIST those lines that contain errors . libfile The name of the HP P ascal/iX library file that the compiler searches if a search path is not specified with the compiler option SEARCH . The default is PASLIB in your gr[...]

Chapter 6 423 Command Definitions P-R P ASXL NO TE Program development in native mode uses the MPE/iX LINK command not the MPE V/E PREP command. This produces a significant change in the method of linking code. If you have created a program called MAIN and a subprogram called SUB , each contained in a separate file, you might c hoose to handle i[...]

424 Chapter 6 Command Definitions P-R P ASXLGO P ASXLGO Compiles , links, and executes an HP P ascal/iX program. HP P ascal/iX is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately . (Native Mode) Syntax PASXLGO [ textfile ][, [ listfile ][, [ libfile ] ] ] [ ;INFO= quotedstring ] [...]

Chapter 6 425 Command Definitions P-R P ASXLGO NO TE The formal file designators used in this command ( PASTEXT , PASLIB , and PASLIST ) cannot be backreferenced as actual file designators in the command parameter list. F or further information, refer to the "Implicit FILE Commands for Subsystems" discussion of the FILE command. Operat[...]

426 Chapter 6 Command Definitions P-R P ASXLLK P ASXLLK Compiles and links an HP P ascal/iX program. HP P ascal/iX is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purc hased separately . (Native Mode) Syntax PASXLLK [ textfile ][, [ pr ogfile ][, [ listfile ][, libfile ] ] ] [ ;INFO= quotedstrin[...]

Chapter 6 427 Command Definitions P-R P ASXLLK NO TE The formal file designators used in this command ( PASTEXT , PASLIB , and PASLIST ) cannot be backreferenced as actual file designators in the command parameter list. F or further information, refer to the "Implicit FILE Commands for Subsystems" discussion of the FILE command. Operat[...]

428 Chapter 6 Command Definitions P-R P A USE P A USE The P AUSE command allows the current task to be suspended or “sleep” for a specifiec number of seconds .) NO TE This command follows the optional MPE/iX command line syntax. Refer to "Optional F ormat for MPE/iX Commands" at the beginning of this chapter . Syntax PAUSE [ num_sec[...]

Chapter 6 429 Command Definitions P-R P A USE sessions without a job name. When more than one job or session matc hes jobid PAUSE sleeps while all matching jobs are in their "while_state". If the job executing PAUSE matches jobid it will not be selected. interval_secs If interval_secs is specified PAUSE sleeps for this many seconds betw[...]

430 Chapter 6 Command Definitions P-R P A USE Examples If a job must read data from a file called LOGDAT.GXK.PROCCTRL , which is to be created by a session, then the job may suspend activity pending a test for the existence of the vital file. The example below shows how the PAUSE command can be used to synchronize a session to some job activity [...]

Chapter 6 431 Command Definitions P-R P A USE The next example sleeps while the backup job ("JB ACKUP ,OP .SYS") has not been streamed. PAUSE reports CIW ARN 9032 if the job is not streamed within 30 minutes. :PAUSE 1800, job="jbackup,op.sys"; notexist The final example polls the system job table every 3 minutes looking for an[...]

432 Chapter 6 Command Definitions P-R PLISTF (UDC) PLISTF (UDC) The PLISTF UDC executes the LISTFILE command to list descriptions of one or more disk files . System-defined UDCs are not automatically available . Y our System Manager must use the SETCATALOG command to make these UDCs available for your use . F or example: SETCATALOG HPPXUDC.PUB.S[...]

Chapter 6 433 Command Definitions P-R PLISTF (UDC) Related Information Commands LISTF, LISTFILE , LISTDIR (UDC), FINDFILE (UDC), FINDDIR (UDC) Manuals None[...]

434 Chapter 6 Command Definitions P-R PREP PREP Prepares a compatibility mode program from a user subprogram library (USL) file onto a program file. Syntax PREP uslfile,progfile [;ZERODB][;CAP= capabilitylist ] [;PMAP] [;RL= filename ] [;MAXDATA= se gsize ] [;PATCH= patchsize ] [;STACK= stacksize ] [;DL= dlsize ] [;NOSYM] [{;FPMAP | ;NOFPMAP}] [...]

Chapter 6 435 Command Definitions P-R PREP stacksize Size of initial local data area (Z-Q initial) stac k, in words. This value , if specified, must be between 511 and 32767 words . This parameter overrides the default stacksize estimated by the MPE segmenter . dlsize DL-DB area to be initially assigned to stack. This area is of interest mainly i[...]

436 Chapter 6 Command Definitions P-R PREP A compiled program is prepared by searching a relocatable library (RL) to satisfy references to external procedures required by the program. When the program is prepared, such procedures are linked to the program in the resulting program file . T o use a relocatable library (RL), you must have READ and L[...]

Chapter 6 437 Command Definitions P-R PREPRUN PREPRUN Prepares and executes a compiled compatibility mode program. Syntax PREPRUN uslfile [, entrypoint ] [;NOPRIV] [;PMAP] [;NOCB] [;DEBUG] [;INFO= quotedstring ] [;LMAP[;STDIN [{ *formaldesig = filer ef $NULL}]]] [;MAXDATA= se gsize ] [;PARM= parameternum ] [;STDLIST=[ { *formaldesig fileref [ ,[...]

438 Chapter 6 Command Definitions P-R PREPRUN LMAP Request to produce a descriptive listing of the allocated (loaded) program to a file whose formal file designator is LOADLIST . If no FILE command referencing LOADLIST is found, the listing is produced on $STDLIST . Default is no listing . ZERODB Request to initialize to zero the initially defi[...]

Chapter 6 439 Command Definitions P-R PREPRUN filename Actual file designator of the relocatable library (RL) file to be searched to satisfy external references during preparation of the program. This can be any permanent file of type RL, to which you must have READ and LOCK access . It need not belong to the logon group, nor does it require a[...]

440 Chapter 6 Command Definitions P-R PREPRUN STDLIST This parameter allows the user to specify the file to be used as $STDLIST by the program being executed. If $STDLIST is omitted, or if nothing is specified after the equal sign, such as $STDLIST= , then $STDLIST defaults to the job or session's standard list device. This parameter has th[...]

Chapter 6 441 Command Definitions P-R PREPRUN T o prepare and execute a program from the USL file UBASE that begins execution at the entry point RESTART , that has a stacksize of 800 words , and searches an RL file named LIBA , enter: PREPRUN UBASE,RESTART;STACK=800;RL=LIBA The following example prepares and runs a program with $STDIN set to the[...]

442 Chapter 6 Command Definitions P-R PRINT PRINT Prints the contents of a file. Syntax PRINT filename [OUT= outfile ] [START= m ] [END= n ] [PAGE= p ] [;UNN | NUM] [;NONUM] P arameters filename Actual file name of the file to be printed to $STDLIST , unless outfile is specified as a destination. T o specify an HFS file , begin the filen[...]

Chapter 6 443 Command Definitions P-R PRINT n Specifies the last record of the file to be displayed. An n is relative to 1. If n is a negative number , it specifies a location relative to the end-of-file, that is , -5 indicates the fifth record from the end-of-file. Zero is an invalid specification. Default is the last record of the file. [...]

444 Chapter 6 Command Definitions P-R PRINT NUM Specifies numbering of the lines as they are displayed. The numbers appear in front of the line (record) being displayed. The number displayed is the actual line number for numbered files; for unnumbered files , relative numbering begins with 1. NONUM Requests that trailing digits at the end of ea[...]

Chapter 6 445 Command Definitions P-R PRINT TAIL MYFILE T o print the last 45 records of MYFILE , because entering the value 45 overrides the default value of 10, enter: TAIL MYFILE, 45 NO TE The PRINT command itself can be used to create a file: PRINT $STDIN,TAILB PARM FILE, LAST=5 PRINT !FILE; START = -!LAST :EOD SAVE TAILB The SAVE command is [...]

446 Chapter 6 Command Definitions P-R PRINT NO TE The above file was considered by PRINT to be a numbered file and thus the trailing 8 bytes are truncated PRINT UFILEYES;NONUM aaaaaaaaaaaa00010001 bbbbbbbbbbbb00010002 cccccccccccc00010003 dddddddddddd00010004 eeeeeeeeeeee00020001 ffffffffffff00020002 gggggggggggg00020003 hhhhhhhhhhhh00020004 iii[...]

Chapter 6 447 Command Definitions P-R PURGE PURGE This command deletes one or more files from the system. Syntax PURGE filereference [ ;TEMP] [ [ ;ONERROR=] { CONTINUE QUIT } ] [ { ;AUTOLOCKWORD ;NOA UTOLOCKWORD } ] [ { ;CONFIRM ;NOCONFIRM ;CONFIRMALL } ] [ { ;NOSHOW ;SHOW } ] [ { ;SHOWERRORS ;NOSHOWERRORS } ] P arameters filer efer ence The ac[...]

448 Chapter 6 Command Definitions P-R PURGE • "N", "NO", or Return to retain the file • "Q", "QUIT", or Break to stop the PURGE command The CONFIRMALL option is ignored in jobs and when you are purging a single file. NOSHOW Suppresses the display of each successfully purged file . NOSHOW is the defaul[...]

Chapter 6 449 Command Definitions P-R PURGE : PURGE /users/jeff/bin/FILES/file@ 3 FILES matched Continue PURGE? (YES/NO) yes 3 selected. 3 succeeded. 0 failed. • T o purge multiple files interactively using wildcards T o purge a number of files, one at a time , in an interactive mode so that you can skip a file or stop your purge, you can use[...]

450 Chapter 6 Command Definitions P-R PURGEA CCT PURGEACCT Removes an account and its groups and users from the system directory or from the specified volume set's directory . Syntax PURGEACCT acctname [ ;ONVS= volumesetname ] P arameters acctname Name of the account to be deleted. This name must contain from one to eight alphanumeric charac[...]

Chapter 6 451 Command Definitions P-R PURGEA CCT CA UTION Do not attempt to purge the SYS account. The SYS account cannot be completely purged, but you can destroy critical files by attempting to do so. If you execute PURGEACCT SYS , all groups except PUB are purged; all users except the system manager are purged; and all inactive files and syst[...]

452 Chapter 6 Command Definitions P-R PURGEDIR PURGEDIR Purges (unlinks) one or more directories . Syntax PURGEDIR [ dir=] dir_name [ { ;TREE ;NOTREE ;USENAME } ] [ { ;CONFIRM ;NOCONFIRM ;CONFIRMALL } ] [ { ;NOSHOW ;SHO W}][{ ;SHOWERROR ;NOSHOWERROR } ] P arameters dir_name The name of the directory that is being purged (required). The dir_name is[...]

Chapter 6 453 Command Definitions P-R PURGEDIR • "N", "NO", or Return to retain the directory • "Q", "QUIT", or Break to stop the PURGE command The CONFIRMALL option is ignored in jobs and when you are purging a single directory . SHOW Displays to $STDLIST each file or directory under dir_name that was [...]

454 Chapter 6 Command Definitions P-R PURGEDIR 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 likely is not what is intended. A file or directory is not deleted if it is being acces[...]

Chapter 6 455 Command Definitions P-R PURGEDIR The next example shows the command to purge MYDIR . PURGEDIR mydir The next example shows the command to purge MYDIR and all objects below . PURGEDIR mydir;TREE The next example illustrates the SHOW and TREE options. PURGEDIR dir;SHOW;TREE ./DIR/A ./DIR/B ./DIR/dir1/A ./DIR/dir1/B ./DIR/dir1 ./DIR/C .[...]

456 Chapter 6 Command Definitions P-R PURGEDIR T o delete all directories under the CWD with names beginning with TMP all objects below these directories: : purgedir TMP@; TREE T o delete all directories under the CWD with names ending with TMP all objects below these directories: : purgedir ./@TMP/ When wildcards are specified with dir_name , th[...]

Chapter 6 457 Command Definitions P-R PURGEGROUP PURGEGROUP Removes a group (and all files belonging to it) from the system or from the specified volume set directory . Syntax PURGEGROUP groupname [. acctname ] [ ;ONVS= volumesetname ] P arameters gr oupname Name of the group in the logon account to be removed. This name must contain from one to[...]

458 Chapter 6 Command Definitions P-R PURGEGROUP If you specify volume-related commands or parameters for a volume set that is not currently mounted, or for an account that does not exist, MPE/iX returns an error message. CA UTION Do not attempt to purge the PUB group of the SYS account. The public group of the system account, PUB.SYS , cannot be [...]

Chapter 6 459 Command Definitions P-R PURGEJOBQ PURGEJOBQ Removes a job queue Syntax PURGEJOBQ qname P arameters qname is the name of the queue to be deleted Operation Notes The PURGEJOBQ command deletes a job queue. The queue will be deleted only if it is empty , that is , if no jobs are waiting or executing in the queue . The default system job [...]

460 Chapter 6 Command Definitions P-R PURGELINK PURGELINK Removes a link. (Native Mode) Syntax PURGELINK [ LINK=] linkname P arameters linkname The name of a symbolic link file. All rules regarding file name specification apply to this parameter . This is a required parameter . Y ou may not use wildcards in linkname or specify a file equation [...]

Chapter 6 461 Command Definitions P-R PURGEUSER PURGEUSER Removes a user from an account. Syntax PURGEUSER user [. acctname ] P arameters user Name of the user to be deleted. acctname Specifies the name of the account in which the user is found. Default is the logon account of the account manager . Operation Notes Account managers use the PURGEUS[...]

462 Chapter 6 Command Definitions P-R PURGEUSER Related Information Commands PURGEACCT , PURGEGROUP , NEWUSER , ALTUSER Manuals P erforming System Management T asks[...]

Chapter 6 463 Command Definitions P-R RECALL/=RECALL RECALL/=RECALL Displays all pending console REPLY messages. Syntax RECALL=RECALL P arameters None. Operation Notes A user , the system operator , a job or a program issues the RECALL command to determine if any pending resource requests are currently aw aiting a response. P ending resource reque[...]

464 Chapter 6 Command Definitions P-R RECALL/=RECALL P erforming System Operation T asks[...]

Chapter 6 465 Command Definitions P-R REDO REDO Allows the user to edit and reexecute any command still retained in the command line history stack. (Native Mode) Syntax REDO [ [ CMD=] cmdid ] [ [ ;EDIT=] editstring ] NO TE This command follows the optional MPE/iX command line syntax. Refer to "Optional F ormat for MPE/iX Commands" at the[...]

466 Chapter 6 Command Definitions P-R REDO The edit string must be surrounded by quotation marks ( " " ) if it contains any scanner/parser delimiters such as: , ; " ' [ ] or = or spaces. Operation Notes REDO executes the command specified as cmdid . The user may specify an optional editstring that edits the command before it i[...]

Chapter 6 467 Command Definitions P-R REDO ^w UPSHIFT WORD . Upshifts the word starting at the position specified by ^ . A word is defined as all characters except a space , comma, or semicolon. If you place the ^ directly beneath a word delimiter , the delimiter is skipped and only the word is upshifted. If no word exists on the command line, n[...]

468 Chapter 6 Command Definitions P-R REDO Editing Samples The T able 6-4 shows examples of using the REDO command. >^ UPSHIFT FROM EOL . Upshifts the character at the current EOL. Y ou may specify multiple ^ 's to upshift a series of characters (read right-to-left) from the EOL. Also, you may follow this directive with other edits . >^[...]

Chapter 6 469 Command Definitions P-R REDO T able 6-4 REDO Editing Samples Edit Action u F irst occurrence undoes the previous edits. The u must be in column one. u Second occurrence undoes all edits on the current line . The u must be in column one. rxyz Replaces the current text with xyz starting at the position of r . xyz Replaces the current t[...]

470 Chapter 6 Command Definitions P-R REDO Use This command is available in a session or in BREAK. It is not available in a job or from a program. Pressing Break aborts the execution of this command. Examples The following are examples of editing options for the REDO command: REDO PAS Edits the most recent command beginning with the string PAS . R[...]

Chapter 6 471 Command Definitions P-R REFUSE REFUSE Disables jobs/sessions and/or data on a designated device. Syntax REFUSE [ JOBS ,] [ DAT A,] ldev P arameters JOBS Disables the JOB (or HELLO ) command from the designated device. DATA Disables the DATA command from the designated device. ldev The logical device number of the device for which JOB[...]

472 Chapter 6 Command Definitions P-R RELEASE RELEASE Removes security provisions from a file. Security does not resume for a released file until you enter the SECURE command for the file. Syntax RELEASE filereference P arameters filereference Specifies the actual file designator of the file whose file access matrix access control you wan[...]

Chapter 6 473 Command Definitions P-R RELEASE Privileged files Y ou cannot release privileged files . Lockwords Y ou cannot override lockwords. ACDs This command does not affect the security on files with access control definitions . However , if you remove the ACD , the file is released. Refer to the ALTSEC command in this book for more info[...]

474 Chapter 6 Command Definitions P-R RELLOG RELLOG Removes a user logging identifier from the system. Syntax RELLOG logid P arameters logid The logging identifier to be removed from the system. Operation Notes The RELLOG command removes a user logging identifier from the system by deleting it from the directory of logging identifiers . This c[...]

Chapter 6 475 Command Definitions P-R RENAME RENAME Changes the file name, loc kword, and/or group name of a disk file. Syntax RENAME oldfilereference,newfilereference [ ;TEMP] P arameters oldfiler efer ence Current name of file, written in the format: [*] filename [ /lockwor d ][. groupname [. acctname ]] T o use HFS syntax, preceed the ?[...]

476 Chapter 6 Command Definitions P-R RENAME Files in HFS directories can be renamed to files in the MPE account group structure, and they can be renamed to files in other HFS directories . Y ou cannot rename a directory . If either oldfiler efer ence or newfiler eference is actually a directory , you will get an error . Spool Files If you hav[...]

Chapter 6 477 Command Definitions P-R REPL Y/=REPL Y REPL Y/=REPL Y Replies to pending resource requests at the console. Syntax REPLY pin,reply =REPLY pin,reply P arameters pin The process identification number (PIN) of the message sender . As part of the message requesting the REPLY , the PIN always appears after the second slash mark ( / ). In [...]

478 Chapter 6 Command Definitions P-R REPL Y/=REPL Y Examples Use the REPLY command to respond to a message from the MPE/iX system, as follows: 10:05/#J19/15/LDEV# FOR "NAS" OF TAPE1600 (NUM)? REPLY 15,7 or CTRL A = REPLY 15,7 Use the REPLY command to respond to a FORMS message from the MPE/iX system, as follows: 15:46/#S93/22/FORMS: PLE[...]

Chapter 6 479 Command Definitions P-R REPORT REPORT Displays accounting information for the logon account and group . Any user may obtain REPORT information about the user's logon group. (Compatibility Mode) Syntax REPORT [ gr oupset ][, listfile ] [ ;ONVS=[ volumesetname ]] P arameters groupset Specifies the accounts and groups for which i[...]

480 Chapter 6 Command Definitions P-R REPORT ? Specifies one alphanumeric character ( A?# = all the three-character names that begin with A , followed by an alphanumeric, followed by a digit.) The characters may be used as follows: n@ Report on all groups starting with the character "n". @n Report on all groups ending with the character[...]

Chapter 6 481 Command Definitions P-R REPORT If you specify the ONVS= parameter , REPORT displays file space counts for the specified volume set(s) only . If you specify a non-system volume, all other volume names are also displayed, but their file space counts are displayed as zero even though they may not be zero. Y ou should always specify O[...]

482 Chapter 6 Command Definitions P-R RESET RESET Cancels file equations . Syntax RESET { formaldesignator @} P arameters formal- designator A formal file designator name in the form file [. group [. account ]] [ :nodespec ] , for which a FILE command has been issued. The nodespec portion may be an environment identifier indicating the locatio[...]

Chapter 6 483 Command Definitions P-R RESET Manuals None[...]

484 Chapter 6 Command Definitions P-R RESET A CCT RESET ACCT Resets the running counts of CPU-time or connect-time accumulated by an account and by all groups within that account to zero. Syntax RESETACCT [{ @ acct } [ ,{ CPU CONNECT } ] ] P arameters @ Specifies that the counters for all accounts , and all groups within the accounts , are to be [...]

Chapter 6 485 Command Definitions P-R RESETDUMP RESETDUMP Disarms the debug facility call that is made during abnormal process termination. (Native Mode) Syntax RESETDUMP P arameters None Operation Notes This command disarms the debug facility (armed by using the SETDUMP command) after a process abort. It affects all processes created later under [...]

486 Chapter 6 Command Definitions P-R REST ORE RESTORE Returns files that have been stored on backup media to the system. Syntax RESTORE [ r estor efile ][; filesetlist ][; option [ ;...] ] where option is: [ ;SHOW [ = showparmlist ]] [ ;ONERROR= { QUIT | SKIP | FULL}] [;{ LOCAL GROUP= gr oupname ACC[OUN]T= accountname }] [;CREATE= { ACCT | GRO[...]

Chapter 6 487 Command Definitions P-R REST ORE If r estor efile is not supplied and the RESTORESET option is not used, then RESTORE creates a default file name. The default file name is the user's logon username. No file equation is used. Sequential and parallel devices are specified with the RESTORESET option. Similarly , magneto-optica[...]

488 Chapter 6 Command Definitions P-R REST ORE The system restores any file that matches filestorestor e unless the file also matches filestoe xclude , which specifies files to be excluded from the RESTORE operation. Y ou may specify an unlimited number of filestoexclude . Since "-" is a valid character for HFS syntax file names [...]

Chapter 6 489 Command Definitions P-R REST ORE @n Restore all files ending with the character n . n##...# Restore all files starting with character n followed by up to seven digits (useful for storing all EDIT/3000 temporary files). n@x Restore all files starting with the character n and ending with the character x . ?n@ Restore all files who[...]

490 Chapter 6 Command Definitions P-R REST ORE Database corruption may result if not all database files are restored from a backup . Be sure that you only w ant to restore certain database files before overriding the default behavior with ;PARTIALDB . MPE and HFS Naming Equivalences When an MPE name component is a single @ wildcard, the @ will b[...]

Chapter 6 491 Command Definitions P-R REST ORE @.@ All (MPE and HFS) files in the logon account. @.@.@ All the files and directories (MPE and HFS) on the system. ?@.@.@ All MPE named files on the system. SHOW Request to list names of restored files . Default is a listing of the total number of all files restored and not restored. F or files [...]

492 Chapter 6 Command Definitions P-R REST ORE SECURITY F or MPE format listing , causes SHOW to display the creator and the file access matrix for all the files which do not have an active ACD . F or files with active ACDs only , the phrase *ACD EXISTS* is displayed. F or HFS format listing, the phrase *ACD EXISTS* or *ACD ABSENT* is displayed[...]

Chapter 6 493 Command Definitions P-R REST ORE If no suboptions are specified, then CREATE defaults to ACCOUNT,GROUP,CREATOR,PATH for SM or OP , to GROUP,CREATOR,PATH for AM, and to PATH for everything else. If CREATE is specified, the necessary directory structures are created, provided the user has the appropriate capabilities . System Manager[...]

494 Chapter 6 Command Definitions P-R REST ORE file gr oupname The file sharing group name which will be the new gid for all files being restored. If this parameter is not specified then the gid on the media is preserved. KEEP If a file on the RESTORE media has the same name as a file already residing on the disk, KEEP instructs the system t[...]

Chapter 6 495 Command Definitions P-R REST ORE FILES= maxfiles If you are restoring a large number of files from an MPE V/E (transport) tape, specify a number at least as large as the number of files to be restored. The default is 4000. This parameter is ignored when you are restoring MPE XL format store tapes . No limit is imposed. When a FILE[...]

496 Chapter 6 Command Definitions P-R REST ORE volumesetname A volume set name. If you specify the VOL or VOLCLASS options , the corresponding volume/volume class name must reside within this volume set. V olume Set Notes VOLSET , VOLCLASS and VOL may not be used with the DEV option. Y ou can inadvertently restore files to groups or accounts that[...]

Chapter 6 497 Command Definitions P-R REST ORE Database corruption may result if not all database files are restored from a backup . Be sure that you only w ant to restore certain database files before overriding the default behavior with ;PARTIALDB . THE FOLLOWING OPTIONS ARE A V AILABLE ONL Y IF TURBOSTORE XL OR TURBOSTORE XL II IS INSTALLED O[...]

498 Chapter 6 Command Definitions P-R REST ORE NAME This parameter must be specified with the MOSET option, and cannot be specified without it. If specifies the logical name to be used for the backup . F or example: RESTORE @.@.@;;MOSET=(12);NAME=DAILY.D23OCT90.BOZO This name could indicate that the restore should be taken from the daily backup[...]

Chapter 6 499 Command Definitions P-R REST ORE The system manager and system supervisor may restore lockword-protected files without specifying the lockword only when RESTORE is executed during a session. Users without SM or OP capability must alwa ys supply the lockword. The exception is AM. If you have AM and you are working in your own account[...]

500 Chapter 6 Command Definitions P-R REST ORE T o restore a file ABC without specifying a r estor efile , no file equation need be used. F or example: : RESTORE ;ABC.PUB.SYS;SHOW TURBO-STORE/RESTORE VERSION A.50.11 HP36398A (C) 1986 HEWLETT-PACKARD CO. WED, NOV 23 1994 11:22 AM WILL RESTORE 1 FILES ; NUMBER OF FILES ON MEDIA 1 FILENAME GROUP A[...]

Chapter 6 501 Command Definitions P-R RESUME RESUME Resumes execution of a suspended operation. (Native Mode) Syntax RESUME P arameters None. Operation Notes After a program or MPE/iX command operation is suspended by pressing Break or by using the CAUSEBREAK intrinsic, the RESUME command resumes execution of the operation at the point where the e[...]

502 Chapter 6 Command Definitions P-R RESUME Manuals None[...]

Chapter 6 503 Command Definitions P-R RESUMEJOB RESUMEJOB Resumes a suspended job. (Native Mode) Syntax RESUMEJOB #J nnn P arameters #J nnn A job number . Operation Notes The system operator uses the RESUMEJOB command to resume processing a job suspended with the BREAKJOB command. The job continues execution from the point at which it was suspende[...]

504 Chapter 6 Command Definitions P-R RESUMELOG RESUMELOG Resumes system logging following suspension caused by an error . (Native Mode) Syntax RESUMELOG P arameters None. Operation Notes When the operator resumes logging with the RESUMELOG command, a special log record is displayed that denotes the number of log events and corresponding records t[...]

Chapter 6 505 Command Definitions P-R RESUMESPOOL RESUMESPOOL Resumes suspended spooler output to a spooled device. Syntax RESUMESPOOL ldev ;BACK [ nnn FILES nnn P AGES ] RESUMESPOOL ldev ;FORWARD [ nnn FILES nnn P AGES ] RESUMESPOOL ldev ;BEGINNING P arameters ldev The logical device number of a spooled device. BACK Instructs the spooler to back [...]

506 Chapter 6 Command Definitions P-R RESUMESPOOL By using the SPOOK utility with mode control ON , you can determine where each FOPEN intrinsic occurs within a spoolfile. This is useful, for example , when you are compiling , preparing , and running large programs, and printing the entire output is unnecessary . Use This command may be issued fr[...]

Chapter 6 507 Command Definitions P-R RETURN RETURN Causes execution to return from the current user command (UDC or command file) to the calling environment. (Native Mode) Syntax RETURN P arameters None Operation Notes This command terminates the execution of the currently executing user command. Control resumes in the calling environment at the[...]

508 Chapter 6 Command Definitions P-R RPG RPG Compiles an RPG/V program in compatibility mode. RPG/V is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purc hased separately . Syntax RPG [ textfile ][, [ uslfile ][, [ listfile ][, [ masterfile ][, [ newfile ]]]]] P arameters textfile The actual ?[...]

Chapter 6 509 Command Definitions P-R RPG NO TE The formal file designators used in this command ( RPGTEXT , RPGUSL , RPGLIST , RPGMAST , and RPGNEW ) cannot be backreferenced as actual file designators in the command parameter list. F or further information, refer to the "Implicit FILE Commands for Subsystems" discussion of the FILE c[...]

510 Chapter 6 Command Definitions P-R RPGGO RPGGO Compiles , prepares, and executes an RPG/V program in compatibility mode . RPG/V is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately . Syntax RPGGO [ textfile ][, [ listfile ][, [ masterfile ][, newfile ]]] P arameters textfile [...]

Chapter 6 511 Command Definitions P-R RPGGO Use This command may be issued from a session, job , or program. It may not be issued in BREAK. Pressing Break suspends the execution of this command. Entering the RESUME command continues the execution. Examples T o compile, prepare , and execute an RPG program entered from your standard input device an[...]

512 Chapter 6 Command Definitions P-R RPGPREP RPGPREP Compiles and prepares an RPG/V program in compatibility mode. RPG/V is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately . Syntax RPGPREP [ textfile ][, [ pr ogfile ][, [ listfile ][, masterfile ][, [ newfile ]]]] P arameters[...]

Chapter 6 513 Command Definitions P-R RPGPREP Operation Notes This command compiles and prepares an RPG program to a program file on disk. If you do not specify textfile , MPE/iX expects the source program to be entered from your standard input device. The USL file $OLDPASS , created during compilation, is a system-defined temporary file pass[...]

514 Chapter 6 Command Definitions P-R RPGPREP Related Information Commands RPG , RPGGO , PREP , RUN Manuals MPE Segmenter Reference Manual RPG/3000 Compiler Reference Manual[...]

Chapter 6 515 Command Definitions P-R RPGXL RPGXL Compiles an RPG/XL program. RPG/XL is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purc hased separately . This command is recognized only if RPG/XL is installed on your system. (Native Mode) Syntax RPGXL [ textfile ][, [ objectfile ][, [ listfile[...]

516 Chapter 6 Command Definitions P-R RPGXL Operation Notes The RPGXL command compiles an RPG/XL program and stores the object code in a file on disk. If textfile is not specified, RPG/XL expects the source program to be entered from your standard input ( $STDIN ). If you do not specify listfile , RPG/XL sends the listing to your standard list[...]

Chapter 6 517 Command Definitions P-R RPGXL RPGXL MAIN, OBJMAIN FTNXL SUB, OBJSUB : LINK FROM=OBJMAIN,OBJSUB;TO=SOMEPROG : RUN SOMEPROG However , if an NMRL is used instead of an NMOBJ , the above can be simplified to the following: BUILD RLFILE;DISC=10000;CODE=NMRL RPGXL MAIN, RLFILE FTNXL SUB, RLFILE LINK RLFILE,SOMEPROG RUN SOMEPROG Related In[...]

518 Chapter 6 Command Definitions P-R RPGXLGO RPGXLGO Compiles , links, and executes an RPG/XL program. RPG/XL is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purc hased separately . This command is recognized only if RPG/XL is installed on your system. (Native Mode) Syntax RPGXLGO [ textfile ][, [[...]

Chapter 6 519 Command Definitions P-R RPGXLGO Use This command may be issued from a session, job , or program. It may not be used in BREAK. Pressing Break suspends the execution of this command. Entering the RESUME command continues the execution. Example T o compile, link, and execute an RPG/XL program entered from your standard input device, wit[...]

520 Chapter 6 Command Definitions P-R RPGXLLK RPGXLLK Compiles and links an RPG/XL program. RPG/XL is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purc hased separately . This command is recognized only if RPG/XL is installed on your system. (Native Mode) Syntax RPGXLLK [ textfile ][, [ pr ogfile [...]

Chapter 6 521 Command Definitions P-R RPGXLLK NO TE This command is implemented as a command file. If you set the HPPATH variable to null ( SETVAR HPPATH "" ), the command file is not executed, and the command fails . Use This command may be issued from a session, job , or program. It may not be used in BREAK. Pressing Break suspends t[...]

522 Chapter 6 Command Definitions P-R RUN RUN Executes a prepared or linked program. (Native Mode) Syntax The only required parameter is progfile . If you specify any other parameters, they will override the default parameters that the creator of the program established, but only for that particular execution of the program. If run is implied , s[...]

Chapter 6 523 Command Definitions P-R RUN The load map for a native mode program or library is a listing that describes the spaces loaded for a process and the linkages used to connect the external references of the process. When the lmap option is selected at run time, the listing is produced for the program and for each library specified by the[...]

524 Chapter 6 Command Definitions P-R RUN The sid (space ID) is the 32-bit virtual space number that was assigned for that space when it was loaded. The offset is the byte offset within the space relative to its beginning . The next grouping shows the condition of the shared global flag for this module. This information is only shown if the flag[...]

Chapter 6 525 Command Definitions P-R RUN Stub This symbol marks an import (outbound). The Link Editor creates an import stub for the unsatisfied code symbols , and the Loader satisfies the reference by filling in the XRT entry allocated for this stub. Plabl This symbol defines an export stub for a procedure for which a procedure label has bee[...]

526 Chapter 6 Command Definitions P-R RUN A DXRT entry is indexed negatively from the DP of the SOM. The DXRT column gives this offset, which is in bytes . The value is in hexadecimal format. The DXRT Addr column gives the indirect address for the import symbol. The last column gives the access rights for the symbol. Process Data Dictionary Area |[...]

Chapter 6 527 Command Definitions P-R RUN Continuing with the PDD area, the remaining columns starting with Type through R/W are interpreted in the same manner as explained in the Export Data Section. Compatibility Mode A compatibility mode loader map shows information on the origin and destination of the reference. The exact origin or destination[...]

528 Chapter 6 Command Definitions P-R RUN DEBUG Instructs the process to enter the system debugger just before executing the first instruction of the program. Once the debugger has been invoked, the commands available to the user depend upon the user's assigned capability . The default is not to enter the system debugger . This parameter is [...]

Chapter 6 529 Command Definitions P-R RUN The default is -1, which currently instructs MPE/iX to assign a system-defined constant as the value of nmstacksize . nmheapsize The maximum size, in bytes , to which the NM heap ma y grow . This must be a decimal number . If a value is specified which is less than the system-defined minimum (including [...]

530 Chapter 6 Command Definitions P-R RUN In a list of libraries , each library must have a privilege level equal to or greater than the privilege level of the library that precedes it in the list. The privilege level of any file is governed by the privilege level of the group in which it resides . F or example, RUN PROGA. grp.acct ;XL='LIB1[...]

Chapter 6 531 Command Definitions P-R RUN appear as can t'', " and " must appear as ""and"" , 'but ' must appear as but''''. The maximum length of the string , including delimiters, is 255 characters . Refer to "Examples." If the executing program is a compatibility mo[...]

532 Chapter 6 Command Definitions P-R RUN $NULL The actual file designator of a system-defined file that is alwa ys treated as an empty file. When referenced by another program, a program receives only an end-of-file indication when accessed. When referenced by a program as $STDLIST , the associated write request is accepted by MPE/iX, but no[...]

Chapter 6 533 Command Definitions P-R RUN NO TE NM and CM loader error messages are reported differently , allowing you to determine the system in which the error occurred. NM Loader Error: ErrMessage (``LDRERR nnnn )'' CM Loader Error: ErrMessage (``LOAD ERR nnnn )'' The RUN command is parsed by the Compatibility Mode parser u[...]

534 Chapter 6 Command Definitions P-R RUN The next example runs a program using the STDIN parameter , setting $STDIN to an existing disk file named INPUT , this time referenced through a file equation. T o set $STDLIST to a temporary disk file named RESULTS that is automatically created by the RUN command, enter: FILE INFILE=INPUT,OLD RUN TESTP[...]

Chapter 7 535 Command Definitions S-SO 7 Command Definitions S-SO[...]

536 Chapter 7 Command Definitions S-SO SA VE SA VE Saves a file in the permanent system file domain. Syntax SAVE { $OLDP ASS , newfiler efer ence tempfiler efer ence } P arameters $OLDPASS A system-defined temporary file. After this file is sa ved, it can no longer be referenced by the name $OLDPASS . newfile-r eference New actual file de[...]

Chapter 7 537 Command Definitions S-SO SA VE This command applies only to temporary files on disk. It is similar to opening a file with the FOPEN intrinsic, and then c losing it with the FCLOSE intrinsic, using a permanent file disposition. Use the SAVE command to save KSAM XL files. Since the KSAMUTIL utility is not supported for KSAM XL, the[...]

538 Chapter 7 Command Definitions S-SO SECURE SECURE Reinstates all file security provisions that you previously suspended with the RELEASE command. Syntax SECURE filereference P arameters filer efer ence Specifies the actual file designator for which you w ant to reinstate file access control. The filereference can be either in MPE or HFS [...]

Chapter 7 539 Command Definitions S-SO SECURE Example • T o reinstate file access control previously in effect for the file named FILE1 , enter: : SECURE FILE1 Related Information Commands ALTSECT , LISTF , LISTFILE , RELEASE ' Manuals None[...]

540 Chapter 7 Command Definitions S-SO SEGMENTER SEGMENTER Starts the MPE segmenter . Syntax SEGMENTER [ listfile ] P arameters listfile Actual file designator of an ASCII output file that is to receive listed output from the MPE segmenter . F ormal file designator is SEGLIST . Default is $STDLIST . Usually this file is a line printer . This[...]

Chapter 7 541 Command Definitions S-SO SEGMENTER Related Information Commands FILE Manuals MPE Segmenter Reference Manual[...]

542 Chapter 7 Command Definitions S-SO SET SET Defines elements of the command interpreter . It also allows a job using a spooled $STDLIST to mark its standard list device for deletion when the job terminates . (Native Mode) Syntax SET[ STDLIST={ DELETE | SAVE } ] [;MSG={ON | OFF}] [ECHO={ ON| OFF}][ ;SPEED={ 300 | 1200 | 2400 | 4800 | 9600 | 192[...]

Chapter 7 543 Command Definitions S-SO SET Example The following example illustrates using the SET command from within a program: !JOB EXAMPLE, USER.TECHPUB,XGROUP !CONTINUE !RUN UPDATE.PUB.SYS;PARM=1;MAXDATA=16000 !IF JCW < FATAL THEN !SET STDLIST=DELETE !ENDIF !EOJ Related Information Commands SETMSG , SPEED , ECHO Manuals None[...]

544 Chapter 7 Command Definitions S-SO SETCA T ALOG SETCA T ALOG Catalogs , or enables, the user -defined commands (UDCs) in a specified catalog file at the user , account, or system level. Y ou can also use this command to disable all UDCs on the system. (Native Mode) W ARNING If you do not specify a catfilename , all UDC's are disabled [...]

Chapter 7 545 Command Definitions S-SO SETCA T ALOG DELETE Deletes the file(s) from the existing UDC directory . This permits the user to delete individual files from the catalog directory . The original order of the catalog is maintained. It also finds and makes adjustments for logon UDCs . The ACCOUNT and SYSTEM options allow the user to dele[...]

546 Chapter 7 Command Definitions S-SO SETCA T ALOG SETCATALOG UDCA, UDCB SETCATALOG UDCA SETCATALOG UDCB ;APPEND In the first example, the command has an implied RESET , and thus overwrites the previous file set in the directory . In the second example, UDCA is entered into the directory , and then UDCB is appended to the directory without affe[...]

Chapter 7 547 Command Definitions S-SO SETCLOCK SETCLOCK Alters the system time or system time zone. SYNT AX SETCLOCK{DATE= date spec ; TIME= time spec [ ;GRADUAL | ;NOW]} {CORRECTION= corr ection spec } {TIMEZONE= time zone spec } { ;CANCEL} P arameters date spec A specification of local date in the form mm/dd/yy[yy] . The year may be expressed [...]

548 Chapter 7 Command Definitions S-SO SETCLOCK NOW This option is meaningful only when the date and time specifications are provided. NOW forces the change to be immediate . See the warning in the Operation Notes section about the dangers of changing the system time immediately . CANCEL Cancels a current time correction. Any correction which has[...]

Chapter 7 549 Command Definitions S-SO SETCLOCK On the HP3000 Universal Time (GMT) is calculated by starting with local time and adding or subtracting a time zone offset. When changing time zones (such as moving from Standard to Daylight Savings Time and bac k) the local time is altered, but this change must not affect Universal Time. T o prevent [...]

550 Chapter 7 Command Definitions S-SO SETCLOCK Any time during an on-going correction, issuing this command with the ;CANCEL parameter will immediately set the correction to zero and cause the system clock to resume its normal pace. Any previous correction will remain. When this option is used, the system will report the amount of correction whic[...]

Chapter 7 551 Command Definitions S-SO SETCLOCK 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 effects on the system's wor[...]

552 Chapter 7 Command Definitions S-SO SETCLOCK Examples of the T ime Zone F orm: Moving from Standard Time to Daylight Savings T ime: The following example illustrates changing the system time zone offset from 8 hours 00 minutes in the W estern Hemisphere (P acific Standard Time) to 7 hours 00 minutes in the W estern Hemisphere (P acific Da yli[...]

Chapter 7 553 Command Definitions S-SO SETCOUNTER SETCOUNTER Sets the next value of a specified resource counter , and optionally enables automatic rollback when a specified limit is reached. Duplicate values are a voided. Syntax SETCOUNTER[ COUNTER=] [ INSP | OUTSP | JOBNUM | SESSNUM ] [ ;BASE = num ] [ ;MAX = num ] [ ;SHOW] P arameters INSP Sp[...]

554 Chapter 7 Command Definitions S-SO SETCOUNTER in force. Once MAX is reached, the next value tried is the BASE value. If you specify a non-zero value for MAX , it must be greater than the current BASE for the corresponding counter , but less than the maximum possible value The BASE keyword causes the specified counter to be immediately yanked [...]

Chapter 7 555 Command Definitions S-SO SETCOUNTER Manuals None[...]

556 Chapter 7 Command Definitions S-SO SETDUMP SETDUMP Arms the system debug facility for a process abort. (Native Mode) Syntax SETDUMP [ DB [ ,ST [ ,QS ]]][ ;ASCII] [ ;DEBUG=" commands "] P arameters DB This parameter is ignored. ST This parameter is ignored. QS This parameter is ignored. ASCII This parameter is ignored. " commands[...]

Chapter 7 557 Command Definitions S-SO SETDUMP Example T o arm the stackdump/debug facility , enter: SETDUMP Related Information Commands DEBUG , RESETDUMP Manuals System Debug Reference Manual[...]

558 Chapter 7 Command Definitions S-SO SETJCW SETJCW Creates or assigns a value to a job control word (JCW) variable. Syntax SETJCW jcwname delimiter value [ {+- } value ] P arameters jcwname The name of a new or existing user -defined or system-defined job control word (JCW). Y ou can use @ to specify all currently defined JCWs. Y ou may not s[...]

Chapter 7 559 Command Definitions S-SO SETJCW SETJCW PROGCNTR 0 .... SETVAR PROGCNTR 65536 JCW VARIABLE RECLASSIFIED AS A STANDARD VARIABLE (CIWARN 8126) PROGCNTR is now a user -defined variable and does not function as a job control word. JCWs can be tested against specific values . The user can use IF and WHILE conditional statements that act [...]

560 Chapter 7 Command Definitions S-SO SETJCW The result of a mathematical operation must be in the range of 0 to 65,535, inclusive; if the number is out of range, an error message is generated, and the value of the JCW remains unchanged. When the result of an operation is greater than the value of the next "step", the JCW value displaye[...]

Chapter 7 561 Command Definitions S-SO SETJCW The following example shows the use of the CIERROR JCW : LISTF ^ UNKNOWN COMMAND NAME. (CIERR 975) SHOWJCW CIERROR CIERROR = 975 RUN ^ NO PROGRAM FILE SPECIFIED. (CIERR 600) SHOWJCW CIERROR CIERROR = 600 : System-Reserved JCWs The system-reserved JCWs are HPMINUTE , HPHOUR , HPDAY , HPDATE , HPMONTH , [...]

562 Chapter 7 Command Definitions S-SO SETJCW In the following example the CONTINUE command prevents an abort in case of errors; the RUN CHEKPROG edits , verifies, and counts valid transactions; the IF command specifies that if no fatal errors occur , schedule shipments; the RUN command schedules the shipments; the ELSE command produces the erro[...]

Chapter 7 563 Command Definitions S-SO SETMSG SETMSG Enables or disables the receipt of user or operator messages at the standard list device. Syntax SETMSG { OFF ON } P arameters OFF Sets job or session to quiet mode and blocks the receipt of TELL command messages from other users . ON Enables user or operator messages to be received and displaye[...]

564 Chapter 7 Command Definitions S-SO SETV AR SETV AR Assigns values to MPE/iX variables . (Native Mode) Syntax SETVAR varname { <space> , ; } expr ession P arameters varname The variable that is to be set to a value. expr ession The expression that is evaluated and assigned to varname . Operation Notes This command assigns values to MPE/iX[...]

Chapter 7 565 Command Definitions S-SO SETV AR Note that all variables are global, so the CI variable name should not be the same as the JCW name that is being used or the operation of the code that uses that JCW will be affected. Compound logical expressions can be formed using the AND , NOT , XOR, and OR logical operators , and nested within par[...]

566 Chapter 7 Command Definitions S-SO SHO W ALLOCA TE SHOW ALLOCA TE Displays status information about the ALLOC ATE command. Syntax SHOWALLOCATE [ STA TUS[ , listfile ] ALLOCA TE [ ,[ fileset ][, listfile ]] ALL[ ,[ fileset ][, listfile ]] ] P arameters STATUS Request to display a summary of status information includes: (1)Number of program[...]

Chapter 7 567 Command Definitions S-SO SHO W ALLOCA TE # specifies one numeric character . ? specifies one alphanumeric character . The characters can be used as follows: n@ All files starting with the character n . @n All files ending with the character n . n@x All files starting with the character n and ending with the character x . n##..# [...]

568 Chapter 7 Command Definitions S-SO SHO W ALLOCA TE SPOOK5.PUB.SYS . . . . . . . . 1 SLPATCH.PUB.SYS . . . . . . . . 0 NUMBER OF PROGRAMS FOUND = 2 T o display summary status information regarding allocation. SHOWALLOCATE STATUS ALLOCATION STATUS NUMBER OF PROGRAMS ALLOCATED = 3 ALLOCATION RELATED TABLES SIZE %USED CODE SEGMENT TABLE 191 52 CST[...]

Chapter 7 569 Command Definitions S-SO SHO W ALLO W SHOW ALLOW Displays which operator commands ha ve been allowed. Syntax SHOWALLOW [ { @.@ user .@ @. acct user .acct }] P arameters @ All users , if used in place of user , or all accounts, if substituted for acct . Default is that the commands allowed for the logged-on user are displayed. user De[...]

570 Chapter 7 Command Definitions S-SO SHO WCA T ALOG SHOWCA T ALOG Displays information about user -defined commands (UDCs). (Native Mode) Syntax SHOWCATALOG [ listfile ] [ ;USER= username [. acctname ]] P arameters listfile An arbitrary file name that identifies the output from SHOWCATALOG that is sent to the line printer . Specifying list?[...]

Chapter 7 571 Command Definitions S-SO SHO WCA T ALOG Examples T o display the account-level UDC files of all users in the GRIMSBY account, enter: SHOWCATALOG ;USER=@.GRIMSBY T o display the system-level UDC files of all users in all accounts , enter: SHOWCATALOG ;USER=@.@ T o display all UDC command files for the current user and send the list[...]

572 Chapter 7 Command Definitions S-SO SHO WCLOCK SHOWCLOCK Displays information about the system date and time . SYNT AX SHOWCLOCK P arameters None. Operation Notes Prints the current time, date , the time correction in effect, and the time zone. See the command SETCLOCK for information about time correction and time zone. Use This command may be[...]

Chapter 7 573 Command Definitions S-SO SHO WDEV SHOWDEV Reports the status of input/output devices . Syntax SHOWDEV [ ldev classname ] [ ;ACD] P arameters ldev Logical device number of device for which status information is to be displayed. This number is unique for each device . Default is that status information for all system devices on the sys[...]

574 Chapter 7 Command Definitions S-SO SHO WDEV LDEV Includes the logical device number and may inc lude 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 . AVAIL W The device is a tape with write[...]

Chapter 7 575 Command Definitions S-SO SHO WDEV 1600 Density of 1600 BPI, or the density of the tape is unrecognizable. ASSOCIATION Indicates the logical devices by device class that have been established by the user with the ASSOCIATE command. ACD Access Control Definition. May include any of the following information per username.acctname: R RE[...]

576 Chapter 7 Command Definitions S-SO SHO WIN SHOWIN Reports the status of input device files . Syntax SHOWIN [# I nnn STA TUS ] [ ;SP] [ ; item [; item [ ;...] ] ] P arameters #I nnn Identifies the particular input device file for which information is to be displayed. Default is that MPE/iX displays information for all input device files use[...]

Chapter 7 577 Command Definitions S-SO SHO WIN [#]J nnn Displays the status of all input device files for a specified job. [#]S nnn Displays the status of all input device files for a specified session. ACTIVE, OPENED, or READY Displays the status of all input files in a specified state . ACTIVE displays the status of active device files . [...]

578 Chapter 7 Command Definitions S-SO SHO WIN PRI The outpriority of the device file, requested by the user or adjusted by the system operator . Specified for spooled output device files only . #C The number of copies needed, specified for spooled output device files only . Use This command may be issued from a session, job , program, or in [...]

Chapter 7 579 Command Definitions S-SO SHO WJCW SHOWJCW Displays the current state of one or more job control word (JCW) variables . Syntax SHOWJCW [ jcwname ] P arameters jcwname The name of a valid job control word (JCW) variable. Default is that all user -defined and system-defined JCWs are displayed. Operation Notes The SHOWJCW command is us[...]

580 Chapter 7 Command Definitions S-SO SHO WJCW Examples T o show the current state of all user -defined and system-defined JCWs, enter: SHOWJCW JCW = 0 CIERROR = 0 T o display the current state of a valid user -defined job control word named JCW1 , enter: SHOWJCW JCW1 JCW1=3 T o display the contents of a system-reserved JCW , enter: SHOWJCW HP[...]

Chapter 7 581 Command Definitions S-SO SHO WJOB SHOWJOB Displays status information about jobs/sessions . Syntax SHOWJOB [ [ #] S nnn [# ]J nnn STATUS SCHED item [; item [ ;...] ] ] [ ;* listfile ] [ ;JOBQ] P arameters # S nnn The session number (assigned by MPE/iX) of the session for which the status information is to be displayed. The informati[...]

582 Chapter 7 Command Definitions S-SO SHO WJOB P arameters for Item JOB= A list of jobs/sessions for which status information is to 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 . Default. [ jsn[...]

Chapter 7 583 Command Definitions S-SO SHO WJOB 7 JOBS: 0 INTRO 0 WAIT; INCL 0 DEFERRED 7 EXEC; INCL 7 SESSIONS 0 SUSP JOBFENCE= 0; JLIMIT= 3; SLIMIT= 16 If the SHOWJOB SCHED command is used, the output is displayed as shown below . The STATE field shows that the job is scheduled. The SCHEDULED-INTRO field shows the time and date the job will be[...]

584 Chapter 7 Command Definitions S-SO SHO WJOB JOBNUM STATE IPRI JLIST JOBQ INTRODUCED JOB NAME #J3 EXEC LP HPSYSJQ WED 11:46A FTPMON,FTP.SYS #J7 EXEC LP SYSMGRQ WED 5:47P EMG,MGR.SYSMGR #S81 EXEC 34 THU 12:17P MGR.GOPI The following example of a SHOWJOB command sequence illustrates an override of the default characteristics of listfile with the[...]

Chapter 7 585 Command Definitions S-SO SHO WLOG SHOWLOG Displays the number of the system's current log file and the percentage of disk space used. (Native Mode) Syntax SHOWLOG P arameters None. Operation Notes The log file number , xxxx , and percentage of file space used, yy , is displayed in the format: SYSTEM LOG FILE # xxxx IS yy % FU[...]

586 Chapter 7 Command Definitions S-SO SHO WLOGST A TUS SHOWLOGST A TUS Displays status information about currently opened user logging files assigned to a logging identifier . Syntax SHOWLOGSTATUS [ logid ] P arameters logid Displays status of the user logging file associated with the logging identifier , logid , created by the GETLOG command[...]

Chapter 7 587 Command Definitions S-SO SHO WLOGST A TUS CUR-F The current file number in the set. Use This command may be issued from a session, job , program, or in BREAK. Pressing Break has no effect on this command. Example Refer to "Operation Notes ." Related Information Commands ALTLOG , CHANGELOG , GETLOG , LISTLOG , LOG , OPENLOG[...]

588 Chapter 7 Command Definitions S-SO SHO WME SHOWME Reports the status of a job or session. (Native Mode) Syntax SHOWME P arameters None. Operation Notes T o display the status of the current job/session enter: SHOWME USER: #S485,MGR.DSUSER,PUB (NOT IN BREAK) RELEASE: V.UU.FF MPE XL HP31900 A.11.70 USER VERSION: V.UU.FF CURRENT: MON, MAY 7, 1987[...]

Chapter 7 589 Command Definitions S-SO SHO WME CURRENT Shows the current time and date. LOGON Shows the logon time. CPU SECONDS Shows the central processor time (CPU) used by this job/session. NO TE SHOWME calculates CPU usage by adding the local CPU usage of the current process to the accumulated total of all terminated processes . The CPU usage [...]

590 Chapter 7 Command Definitions S-SO SHO WOUT SHOWOUT Displays the status of output device files . Syntax SHOWOUT [{ # O nnn STATUS SP item [; item [ ;...] ] } ] P arameters #O nnn Identifies a particular output device file for which you w ant information. The information is displayed in Type I format, which is described in the "Operatio[...]

Chapter 7 591 Command Definitions S-SO SHO WOUT JOB= Displays the status of output device files using one of the following options: @J Displays the status of output device files for all jobs . @S Displays the status of output device files for all sessions . @ Displays the output device files for all jobs and sessions . [#]J nnn Displays all ou[...]

592 Chapter 7 Command Definitions S-SO SHO WOUT DFID Device file identification, which begins with the letter O (not zero) followed by a number . The numeric portion of the DFID is identical to the LDEV number of the device. JOBNUM The job/session number ( jsnum ) of job or session using the device file. FNAME File name assigned to device file[...]

Chapter 7 593 Command Definitions S-SO SHO WOUT Use This command may be issued from a session, job , program, or in BREAK. Pressing Break aborts the execution of this command. Examples T o display the total number of output device files currently existing, the number of those that are spooled, and their current status , enter: SHOWOUT STATUS 11 F[...]

594 Chapter 7 Command Definitions S-SO SHO WPROC SHOWPROC Displays information about the specified process(es). (Native Mode) Syntax SHOWPROC[ [ PIN=]{ pinspec | ( pinspec [ , pinspec ] ...)}] [[;JOB=]{ jobspec | ( jobspec [ , jobspec ] ...)}] [[;FORMAT=]{SUMMARY | DETAIL}] [{;TREE | ;NOTREEE}] [{;USER | ANYUSER}] [{;SYSTEM}] [{;TRUNC | ;NOTRUNC}[...]

Chapter 7 595 Command Definitions S-SO SHO WPROC An ordinary user can only see their own processes , even when jobspec is wildcarded. F or example, if the user name is JEFF .MFG and you enter the command as shown below , then only processes for jobs logged on as JEFF .MFG are displayed. : SHOWPROC job=@J On the other hand, if the user STEVE.UI (wh[...]

596 Chapter 7 Command Definitions S-SO SHO WPROC ANYUSER This option defeats the filtering of the wildcarded jobspec and displays all matching processes . SM or OP capability is necessary to specify ANYUSER , and users with these capabilities get ANYUSER by default. OP or SM users may reduce the SHOWPROC output to just their own processes by usin[...]

Chapter 7 597 Command Definitions S-SO SHO WPROC LOGON (v): The job/session, user , and account name associated with this process. PARENT (5): Process Identification Number for the process' parent (decimal). This field is unique to the DETAIL format. The DETAIL format displays PARENT so that process relationships can be determined. A zero i[...]

598 Chapter 7 Command Definitions S-SO SHO WPROC : SHOWPROC pin=(2,99,121,188);format=detail;system PIN PARENT PRI CPUTIME STATE JOBNUM (PROGRAM) STEP - - - 2 1 142 L 7:23.687 WAIT (LOAD.PUB.SYS) LOGON : PROGRAM : LOAD.PUB.SYS QUEUE : BS WORKGROUP : BS_Default *********************** PIN PARENT PRI CPUTIME STATE JOBNUM (PROGRAM) STEP - - - 99 68 1[...]

Chapter 7 599 Command Definitions S-SO SHO WPROC C152 0:02.000 WAIT S12 38 (TDP.PUB.SYS) text myfile C152 0:01.030 READY S12 67 (FCOPY.PUB.SYS)from=foo.pub.sys;to=ba r;new Example T o display a summary of information for all non-system processes in the current job/session, enter: : SHOWPROC T o display a summary of information for PIN 42, enter: :[...]

600 Chapter 7 Command Definitions S-SO SHO WQ SHOWQ Displays scheduling data for all processes and the sc heduling characteristics of the CS , DS and ES scheduling subqueue(s). (Native Mode) SYNT AX SHOWQ [ ;ACTIVE] [ ;STA TUS] P arameters ACTIVE Displays only the processes currently running or those about to run. This is the right-hand portion of[...]

Chapter 7 601 Command Definitions S-SO SHO WQ Each entry in the three columns displays the following information for a single process; the meaning is explained below . { A B C D E } [ M U ] pin [ #Jnnn #Snnn ] A the queue attribute of the process is AS B the queue attribute of the process is BS C the queue attribute of the process is CS D the queu[...]

602 Chapter 7 Command Definitions S-SO SHO WQ Example T o display the active processes and the current scheduling subqueue characteristics , enter: : SHOWQ;ACTIVE DORMANT RUNNING Q PIN JOBNUM Q PIN JOBNUM C M163 #S263 C U215 #S256 QUANTUM QUEUE BASE LIMIT MIN MAX ACTUAL BOOST TIMESLICE - - - - - - CQ 152 200 1 2000 200 DECAY 200 DQ 202 238 2000 20[...]

Chapter 7 603 Command Definitions S-SO SHO WTIME SHOWTIME Prints current time and date. (Native Mode) Syntax SHOWTIME P arameters None. Operation Notes Prints current time and date, as indicated by system c lock. Use This command may be issued from a session, job , program, or in BREAK. Pressing Break has no effect on this command. Example T o dis[...]

604 Chapter 7 Command Definitions S-SO SHO WV AR SHOWV AR Displays specific variable names and their current values . (Native Mode) Syntax SHOWVAR[ varid] [ ,varid] ... [ ,varid] [job= jobID] [;USER | HP | ANY] P arameters varid The name of the variable for which the current value is to be displayed. jobid The job or session number who’ s varia[...]

Chapter 7 605 Command Definitions S-SO SHO WV AR T able 7-2 Specified V ariable-ID/Result Y ou may use the wildcard characters @ , # , ? , and [ ] to specify a set or range of variables or file names in many commands . @ Specifies zero or more alphanumeric characters , or the underbar character ( _ ). Used by itself , it specifies all possible[...]

606 Chapter 7 Command Definitions S-SO SHO WV AR T o display all variables created by the user with the SETVAR , INPUT , or SETJCW command, or with the HPCIPUTVAR , PUTJCW , or SETJCW intrinsics, enter: SHOWVAR T o display all variables created currently in the variable table, those created by the user and all predefined variables , enter: SHOWVA[...]

Chapter 7 607 Command Definitions S-SO =SHUTDO WN =SHUTDOWN Initiates a shutdown of MPE/iX. Syntax =SHUTDOWN [ system terminal dtc tape disc network other ] P arameters None. Operation Notes The =SHUTDOWN command performs an implicit =LOGOFF of all sessions, including the session logged at the system console. All system processes are stopped in an[...]

608 Chapter 7 Command Definitions S-SO =SHUTDO WN Use This command may be issued only at the physical console . Example T o shut the system down, first issue a warning to all users to allow them time to log off , and then execute =SHUTDOWN as shown below: WARN @;SYSTEM WILL SHUTDOWN IN FIVE MINUTES. PLS LOG OFF. CTRL A = SHUTDOWN 10:49/#S40/25/LO[...]

Chapter 7 609 Command Definitions S-SO SHUTQ SHUTQ Closes the spool queue(s) for the specified logical device, device name , or all members of a device class . (Native Mode) Syntax SHUTQ { ldev [ ;SHOW] devclass [ ;SHOW] devname [ ;SHOW] @ } P arameters ldev The logical device number of the device . devclass The device class name of the devices .[...]

610 Chapter 7 Command Definitions S-SO SHUTQ Examples T o shut the queue for all devices in class LP , enter: SHUTQ LP T o shut the spool queue and show the state of the queue and other information about the specified device, enter: SHUTQ 6;SHOW Related Information Commands OPENQ , STARTSPOOL , SPOOLER Manuals Native Mode Spooler Reference Manual[...]

Chapter 8 611 Command Definitions SP-Z 8 Command Definitions SP-Z[...]

612 Chapter 8 Command Definitions SP-Z SPEED SPEED Sets the input and output speed for the user's terminal. Syntax SPEED newinspeed , ne woutspeed or SET SPEED = newspeed P arameters newinspeed The new input speed in characters-per -second (CPS). The input and output speeds must alwa ys be equal. Acceptable values for newinspeed and newoutspe[...]

Chapter 8 613 Command Definitions SP-Z SPEED Use This command may be issued from a session, program, or in BREAK. This command is not available from a job . Pressing Break has no effect on this command. Examples T o manually change the speed and enter MPE (the { is a random character), enter: CHANGE SPEED AND INPUT "MPE": { T o change th[...]

614 Chapter 8 Command Definitions SP-Z SPL SPL Compiles a compatibility mode SPL/V program. SPL/V is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purc hased separately . Syntax SPL [ textfile ][, [ uslfile ] [, [ listfile ][, [ masterfile ][, newfile ] ] ] ] [ ;INFO= quotedstring ] P arameters [...]

Chapter 8 615 Command Definitions SP-Z SPL newfile Actual file designator of the file created by merging textfile and masterfile . This can be any ASCII output file. F ormal designator is SPLNEW . Default is that no file is written. NO TE The formal file designators used in this command ( SPLTEXT , SPLUSL , SPLLIST , SPLMAST , and SPLNEW )[...]

616 Chapter 8 Command Definitions SP-Z SPL Related Information Commands SPLGO , SPLPREP , PREP , RUN Manuals Systems Programming Language Reference Manual[...]

Chapter 8 617 Command Definitions SP-Z SPLGO SPLGO Compiles , prepares, and executes a compatibility mode SPL/V program. SPL/V is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately . Syntax SPLGO [ textfile ] [ , [ listfile ] [, [ masterfile ] [, newfile ]]][ ;INFO= quotedstring ][...]

618 Chapter 8 Command Definitions SP-Z SPLGO Operation Notes This command compiles , prepares, and executes an SPL program. If textfile is omitted, MPE/iX expects input from your standard input device. This command creates a temporary user subprogram library (USL) file ( $NEWPASS ) that you cannot access and a temporary program file that you ca[...]

Chapter 8 619 Command Definitions SP-Z SPLPREP SPLPREP Compiles and prepares a compatibility mode SPL/V program. SPL/V is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately . Syntax SPLPREP [ textfile ][, [ pr ogfile ] [, [ listfile ] [, [ masterfile ] [, newfile ] ] ] ] [ ;INFO=[...]

620 Chapter 8 Command Definitions SP-Z SPLPREP quotedstring A sequence of ASCII characters bounded by a pair of single quotation marks (apostrophes) or by double quotation marks . If you want a quotation to appear within quotedstring , the quotation and its quotation marks must also be bounded by quotation marks . F or example , to insert "an[...]

Chapter 8 621 Command Definitions SP-Z SPLPREP Related Information Commands SPL , SPLGO , PREP , RUN Manuals MPE Segmenter Reference Manual System Programming Language Reference Manual[...]

622 Chapter 8 Command Definitions SP-Z SPOOLER SPOOLER Controls spooler processes . (Native Mode) Syntax SPOOLER[ DEV=] { ldev | devclass | devname } { ;SHOW } { ;OPENQ [;SHOW]} { ;SHUTQ [ ;SHOW]} { ;START [ ;OPENQ | ;SHUTQ] [ ;SHOW]} { ;STOP [ ;FINISH | ;NOW] [ ;OPENQ | ;SHUTQ] [ ;SHOW]} { ;SUSPEND[[ ;FINISH | ;NOW][ ;NOKEEP | ;KEEP] | [ ;OFFSET=[...]

Chapter 8 623 Command Definitions SP-Z SPOOLER The STOP parameter terminates the spooling process associated with the specified device. If a c lass is specified, then spooling processes for all devices in the specified class are terminated. A spooler in the active state first moves to the STOP pending state (shown as *STOP with the SHOW option[...]

624 Chapter 8 Command Definitions SP-Z SPOOLER tape and placing it offline). When this is complete, the spooler displa ys the following message on the console (or the $STDLIST of an associated user) and terminates: Input spooler, LDEV # ldev : Stopped. Y ou may determine the spooler state at any time by entering the following: SPOOLER ldev ;SHOW [...]

Chapter 8 625 Command Definitions SP-Z SPOOLER data has been printed before suspending . Depending on both the content of the data and the amount of buffering , this may require a significant part of a page or even several pages . The spooler process notifies you via the following message that it has processed the command: IOutput spooler, LDEV [...]

626 Chapter 8 Command Definitions SP-Z SPOOLER Either a STOP or SUSPEND that includes the FINISH option may be accelerated to a higher -priority command without waiting for the present spool file to finish printing . F or example , SPOOLER...; SUSPEND; FINISH may be followed by: SPOOLER...;SUSPEND;NOW or SPOOLER...;STOP;FINISH or SPOOLER...;STOP[...]

Chapter 8 627 Command Definitions SP-Z SPOOLER prints the file starts the first copy with the page following the page number saved in the FLABX and the file's header and trailer (if any) include (RESUMED) if printing starts anywhere but at the first page . [+/-] page The page parameter may be used only in conjunction with the SUSPEND, RES[...]

628 Chapter 8 Command Definitions SP-Z SPOOLER number of lines that fit on a standard 11-inch page at 6 lines per inch, allowing three lines of margin at the top and the bottom of the page. This is often a flawed assumption, as the following examples show: • F or many applications (for example, A4 paper , 8 lines per inch, and so on) 60 lines [...]

Chapter 8 629 Command Definitions SP-Z SPOOLER Spooler processes come in two varieties: input spoolers and output spoolers . • An input spooler reads data from its device and uses that to create an input spool file. The data may consist of one or more batch jobs , data files , or any combination of the two. Input spool files are private file[...]

630 Chapter 8 Command Definitions SP-Z SPOOLER 4. T o ensure that a file resumes at the beginning , enter: SPOOLER dev ;SUSPEND;NOKEEP;OFFSET=1 When you use the SHOW option, the display shows the current state of the selected spooler(s) at the time the command executor has completed processing the command . This means that the selected spooler(s)[...]

Chapter 8 631 Command Definitions SP-Z SPOOLF SPOOLF Allows a qualified user to alter , print, or delete output spool file(s). (Native Mode) Syntax SPOOLF { [ [ IDNAME=] { spoolid ( spoolid [, spoolid ] . . .) } [ ;DEV= { ldev de vclass devname } ] [ ;PRI= outpri ] [ ;COPIES= numcopies ] [ ;SELEQ= {[ select-eq ]^ indir ect_file } ] [ ;AL TER] [[...]

632 Chapter 8 Command Definitions SP-Z SPOOLF If the file name or set is not fully qualified, the default is the user's current logon group and account. In batch mode , if any file in the set has a lockword, it must be supplied with the command. Therefore , the file cannot be part of a set that contains wildcards . This restriction does n[...]

Chapter 8 633 Command Definitions SP-Z SPOOLF FILE EPOCLONG;DEV=EPOC;ENV=LPLONG.ENV.SYS PRINT MYFILE,*EPOCLONG Y ou may also select files based on a null string by entering FILEDES= "" or FILEDES= ''. Y ou must include such a construct if you specifically w ant to select on such an attribute. Note that "" is not the[...]

634 Chapter 8 Command Definitions SP-Z SPOOLF Y ou may use some wildcards; J@ accepts all jobs , S@ accepts all sessions . J'@ and S'@ are also allowed, The apostrophe (') indicates an imported spool file or a spool file recovered during START NORECOVERY . • parm ::= RECS : Number of records in the spool file. A positive intege[...]

Chapter 8 635 Command Definitions SP-Z SPOOLF • If the resulting string is ≤ 509 characters, it is parsed. • If the parser detects a syntax error , or if any non-blank character follows the closing bracket (]) of the select-eq , an error is returned and the select-eq is not processed. ALTER The ALTER option alters the characteristics of spec[...]

636 Chapter 8 Command Definitions SP-Z SPOOLF NO TE Because of the large amount of data buffered in the file system and the device, an output device ma y continue to print, making it appear as if the DELETE option has not had any effect. In reality , the spooler stops sending data to the device when the command is received but must wait until all[...]

Chapter 8 637 Command Definitions SP-Z SPOOLF The default is 1 for the PRINT option and no change for the ALTER option. SPSAVE The SPSAVE option specifies that the selected spool files are not to be deleted after their last copy has printed. Instead they are retained in the HPSPOOL account in the SPSAVE state until deleted manually . Among other[...]

638 Chapter 8 Command Definitions SP-Z SPOOLF Use This command may be issued from a session, job , or program, or in BREAK. SPOOLF ...;SHOW is breakable. However , you cannot stop the actions by pressing BREAK . The files you can access with the SPOOLF command depend on your capabilities. Example Related Information Commands SPOOLER , LISTSPF , L[...]

Chapter 8 639 Command Definitions SP-Z ST ARTSESS ST ARTSESS Creates a session on the specified device, if the user has programmatic sessions (PS) capability . Syntax STARTSESS ldev [ sessionname ,] user [ / userpass ] . acct [/ acctpass ][ , gr oup [/ gr ouppass ]] [ ;TERM={ termtype }][ [;TIME= cpusecs ] [ ;PRI= {BS | CS | DS | ES}][{ ;INPRI= i[...]

640 Chapter 8 Command Definitions SP-Z ST ARTSESS acct Account name established by the system manager . The name may contain from one to eight alphanumeric characters , beginning with an alphabetic character . A period ( . ) must precede the acct parameter . acctpass Account password, optionally assigned by the system manager . The password may co[...]

Chapter 8 641 Command Definitions SP-Z ST ARTSESS termtype Determines terminal-type characteristics . The value of the termtype parameter determines the type of terminal used for input. MPE/iX uses this parameter to determine device-dependent characteristics such as delay factors for carriage returns . The value must be 10, 18, 20, or 21. The defa[...]

642 Chapter 8 Command Definitions SP-Z ST ARTSESS The HIPRI option is used for two different purposes when logging on. It can be used to override the system jobfence, or it can be used to override the session limit: • When using the HIPRI option to override the jobfence, the system first checks to see if you ha ve system manager (SM) or system [...]

Chapter 8 643 Command Definitions SP-Z ST ARTSESS ciparm The command interpreter parameter number you wish to use. If you are using the MPE/iX command interpreter , the numbers accepted are: 0, 2, 4 Logon UDCs are executed and the CI banner and the WELCOME message are displayed. Default. 1, 3, 5 Same as 0, but the CI terminates after processing th[...]

644 Chapter 8 Command Definitions SP-Z ST ARTSESS Example T o start a session named CH5 , with the username ERNST , accountname UDET , gr oupname JASTA11 , and gr ouppass PASS on LDEV 21, enter: STARTSESS 21;CH5,ERNST.UDET,JASTA11/PASS Related Information Commands TUNE Manuals Process Management Programmer's Guide P erforming System Operation[...]

Chapter 8 645 Command Definitions SP-Z ST ARTSPOOL ST ARTSPOOL Initiates the spooler process for a device. Syntax STARTSPOOL [{ ldev [ ;SHUTQ] devclass }] P arameters ldev The logical device number of a spooled device. When the spooler gains control of the specified device, it controls spooling to it as well as to all device classes that referenc[...]

646 Chapter 8 Command Definitions SP-Z ST ARTSPOOL T o start spooling on logical device 6, while preventing the creation of any new spool files, enter: STARTSPOOL 6;SHUTQ Related Information Commands STOPSPOOL Manuals P erforming System Operation T asks[...]

Chapter 8 647 Command Definitions SP-Z ST OPSPOOL STOPSPOOL T erminates spooling to a specified device or device class. Syntax STOPSPOOL [{ ldev [ ;OPENQ] devclass }] P arameters ldev The logical device number of a spooled device. The spooler process gives up ownership of the spooled device. If the OPENQ parameter is omitted, the device becomes a[...]

648 Chapter 8 Command Definitions SP-Z ST OPSPOOL STOPSPOOL LP T o terminate spooling on device 6 and leave the queue open, enter: STOPSPOOL 6;OPENQ Related Information Commands STARTSPOOL Manuals STORE and T urboST ORE/iX Manual V olume Management Reference Manual[...]

Chapter 8 649 Command Definitions SP-Z ST ORE STORE Copies disk files onto backup media so that they can be recovered with RESTORE. Syntax STORE [[ filesetlist ] [; [ storefile ] [; option [; option [ ...] ] ] ] ] where option is: [ ;SHOW[ = showparmlist ]] [ ;ONERR[ OR] = { REDO QUIT } ] [ { ;DATE<= accdate ;DA TE>= moddate }] [ ;PURGE] [...]

650 Chapter 8 Command Definitions SP-Z ST ORE The following parameters are available with the TurboSTORE/iX 7x24 True-Online Backup product only: [ ;ONLINE[ ={ START} [ , time ] [ ,ASK] ] ] { END} [ ;LOGVOLSET= volumesetname ] P arameters filesetlist Specifies the set of files to be stored. The default set is @ meaning all files in the current[...]

Chapter 8 651 Command Definitions SP-Z ST ORE filename/lockwor d.group.account The HFS syntax is as follows: /dir_lev_1/dir_le v_2/.../dir_lev_i/.../filedesig or ./dir_lev_i/dir_le v_j/.../dir_lev_k/.../filedesig If the name begins with a dot (.), then it is fully qualified by replacing the dot with the current working directory (CWD). Each of[...]

652 Chapter 8 Command Definitions SP-Z ST ORE [c-t] specifies any letter from range c to t . [e-g1] specifies any letter range e to g or digit 1 . Examples of using character sets are: [A-C]@ Store all files that begin with the letters A, B, or C . myset[e-g1] Store all files that begin with the name myset and end in e, f, or g , or 1 . myset [...]

Chapter 8 653 Command Definitions SP-Z ST ORE file.gr oup.acct/ACCT/ GR OUP/FILE ' One particular file in one particular group in one particular account. file.gr oup/LOGON- A CCT/GR OUP/ FILE One particular file in one particular group in the logon account. file ./FILE One particular file in the logon group and account. @.gr oup.acct /A[...]

654 Chapter 8 Command Definitions SP-Z ST ORE @ indicates that the source value for that component should be used. An HFS pathname which ends in a / is considered an HFS directory and no wildcard characters are allowed in the filename . The RENAME option must be specified if the targ etname is used. stor efile The name of the device to which th[...]

Chapter 8 655 Command Definitions SP-Z ST ORE example, if the bac kup disk file specified was /SYS/BACKUPS/DAILY , and STORE ran out of room, it would create /SYS/BACKUPS/DAILY.2 , /SYS/BACKUPS/DAILY.3 , and so on. The additional files are HFS-named files . TurboSTORE/iX 7x24 True-Online Backup must be used to create disk backups . SHOW Speci?[...]

656 Chapter 8 Command Definitions SP-Z ST ORE SECURITY F or MPE format listings, causes SHOW to display the creator and the file access matrix for all the files which do not have an active ACD . F or files with active ACDs only , the phrase *ACD EXISTS* is displayed. F or HFS format listing, the phrase *ACD EXISTS* or *ACD ABSENT* is displayed,[...]

Chapter 8 657 Command Definitions SP-Z ST ORE This option cannot be used for files that are attached to a log set. PURGE Instructs STORE to purge all the files 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 h[...]

658 Chapter 8 Command Definitions SP-Z ST ORE MPEXL (optional) If MPEXL is specified, then STORE writes out MPE XL compatible media. If the TRANSPORT parameter is used and MPEXL is not specified, then MPE V compatible media is produced. This option is used to facilitate transport of files with a later version attribute to older systems . At pre[...]

Chapter 8 659 Command Definitions SP-Z ST ORE provides the ability to restrict, or enhance the creation of directory information on the store tape. If the DIRECTORY option is specified in conjunction with the ONVS option, only those accounting structures on the specified volume sets are stored. Up to twenty volume sets may be specified. volumes[...]

660 Chapter 8 Command Definitions SP-Z ST ORE STOREDIREC TORY Specifies that STORE should create a disc file that contains the backup media label and directory information. This file will be placed in the store_dirs directory of the HPSTORE.SYS group ( /SYS/HPSTORE/store_dirs/ ). If this path does not exist, the directory file will not be crea[...]

Chapter 8 661 Command Definitions SP-Z ST ORE STORESET Specifies parallel and sequential backup devices . This option cannot be used if the storefile parameter is specified, and it cannot be used in conjunction with the TRANSPORT option. Sequential tapes are specified in this wa y ;STORESET = (* tape1 ,* tape2 ,* tape3 ,...) This instructs STO[...]

662 Chapter 8 Command Definitions SP-Z ST ORE compr essionparm list Informs STORE what type of compression is to be done. HIGH and LOW are the only valid parameters . HIGH and LOW cannot be used together . HIGH Specifies that the higher of the two available data compression algorithms is to be used. Although the data will be compressed more, STOR[...]

Chapter 8 663 Command Definitions SP-Z ST ORE ONLINE Online backup . The store fileset is attached to a log handler and the users can concurrently read, write or purge files in the fileset after the files are attached to the log environment. The files must not be open for write before STORE is invoked, but write access is allowed as soon as t[...]

664 Chapter 8 Command Definitions SP-Z ST ORE Operation Notes • Usage The STORE command stores one or more disk files onto magnetic tape DDS or MO disc. It will store only those files whose home volume set(s) is (are) mounted. • Required capabilities for storing files If you have system manager (SM) or system supervisor (OP) capability , yo[...]

Chapter 8 665 Command Definitions SP-Z ST ORE Use If you press [Break] during a STORE operation, the operation continues while you interact with the Command Interpreter . Both ABORT and RESUME can be used within BREAK . This command may be issued from session, job , or program, but not in BREAK . The user must have Privileged Mode (PM) capability [...]

666 Chapter 8 Command Definitions SP-Z ST ORE Note that the console operator receives a request to mount the tape identified as the user's user name. T o store files from a group and account and to purge them after the STORE , enter : FILE T;DEV=TAPE : STORE @.GROUP.ACCOUNT;*T;PURGE Related Information Commands RESTORE , VSTORE , REPLY , RE[...]

Chapter 8 667 Command Definitions SP-Z STREAM STREAM Spools batch jobs or data from a session or job . The optional time-related parameters of the STREAM command may be used to schedule jobs . The time-related parameters are ignored when the STREAM command is applied to the DATA command, however . Syntax STREAM[ filename][ ,char] [ ;AT= timespec ][...]

668 Chapter 8 Command Definitions SP-Z STREAM WED[NESDAY] THU[RSDAY] FRI[DAY] SAT[URDAY] day-of-month Day-of-month. The integers 1 through 31. It indicates the calendar day of the month. If day-of-month is greater than or equal to the current day-of-month , the current month is indicated. If day-of-month is less than the current day-of-month , the[...]

Chapter 8 669 Command Definitions SP-Z STREAM use for this input. As a result, the listing device that corresponds to the streaming device (not necessarily your terminal) displays the job number assigned by MPE/iX and the listing generated by the job. When you enter STREAM without an input file (that is, with the terminal as the default input dev[...]

670 Chapter 8 Command Definitions SP-Z STREAM Pressing Break aborts the execution of this command and any job currently being entered through the command. Incompletely spooled disk space is returned to the system. If you make an error while entering the MPE/iX JOB command, you receive an error message on your job listing device. The system operato[...]

Chapter 8 671 Command Definitions SP-Z STREAM must alwa ys precede it with a delimiting comma, even when you omit the input file name (the first parameter). In the following example, an asterisk ( * ) is used as a substitute command identifier: STREAM ,* >*JOB USER.TECHPUBS >*FORTGO MYPROG *EOJ *#J74 *>: : If your job input file conta[...]

672 Chapter 8 Command Definitions SP-Z STREAM STREAM JOBFILE; DAY=MONDAY; AT=20:00 Since the time specified (8:00 p.m.) is later than the current time , JOBFILE will be introduced at 8:00 p.m., Monda y , June 8. STREAM JOBFILE; DAY=9; AT=20:00 Since the day of the month (9) is later than the current day of the month (8), the current month is assu[...]

Chapter 8 673 Command Definitions SP-Z STREAMS STREAMS Enables or disables the STREAMS device. Allows or disallows users to submit job/data streams . Syntax STREAMS { ldev OFF } P arameters ldev The logical device number of the STREAMS device. This device must also have an output device number or class that references logical devices of type 32. A[...]

674 Chapter 8 Command Definitions SP-Z STREAMS STREAMS OFF Related Information Commands STREAM , SHOWDEV Manuals P erforming System Operation T asks[...]

Chapter 8 675 Command Definitions SP-Z SUSPENDSPOOL SUSPENDSPOOL Suspends output to a spooled device. Syntax SUSPENDSPOOL ldev [ ;FINISH] P arameters ldev The logical device number of a spooled device. FINISH Directs the device to complete the currently active spool file and then stop. Operation Notes When the spooler process is suspended, the me[...]

676 Chapter 8 Command Definitions SP-Z SUSPENDSPOOL Manuals P erforming System Operation T asks[...]

Chapter 8 677 Command Definitions SP-Z SWITCHLOG SWITCHLOG Closes the current system log file, then creates and opens a new one . (Native Mode) Syntax SWITCHLOG P arameters None. Operation Notes When the SWITCHLOG command is executed, MPE/iX displays the previous system log file number ( xxx ), the percentage of file space used ( yy ), and the [...]

678 Chapter 8 Command Definitions SP-Z SWITCHLOG System Startup , Configuration, and Shutdown Reference Manual[...]

Chapter 8 679 Command Definitions SP-Z SYSGEN SYSGEN Starts configuration dialog and/or installation tape creation. The equivalent compatibility mode command is SYSDUMP . (Native Mode) Syntax SYSGEN [ base gr oup ][, newgr oup ][, inputfile ][, outputfile ] P arameters basegroup The name of a base configuration group in the SYS account which c[...]

680 Chapter 8 Command Definitions SP-Z SYSGEN The base for configuration changes or tape creation can be specified on the SYSGEN command with the base group. The group name to whic h the configuration is to be kept with a SYSGEN KEEP command can be specified on the SYSGEN command line with the newgroup parameter . Input for the configurator i[...]

Chapter 8 681 Command Definitions SP-Z TELL TELL Sends a message to another session. Syntax TELL { [ #] S nnn [ sessionname ,] username.acctname @@ . acctname @ S}[[; ] text ] P arameters [#]S nnn The session number as assigned by MPE/iX. This session number receives the TELL message. [ sessionname ] username . acctname The name of the session or [...]

682 Chapter 8 Command Definitions SP-Z TELL TARGET MUST BE INTERACTIVE, NO MESSAGE SENT. (CIWARN 1627). Use This command may be issued from a session, job , program, or in BREAK. Pressing Break has no effect on this command. Examples T o send a message to a user identified as BROWN , logged on under account A , running a session named BROWNSES te[...]

Chapter 8 683 Command Definitions SP-Z TELLOP TELLOP Sends a message to the system console. (Native Mode) Syntax TELLOP [ text ] P arameters text Message text, preceded by a space and consisting of any string of ASCII characters . Default is that no text is printed; however , MPE/iX still prints the FROM as follows: FROM/ sessionid Operation Notes[...]

684 Chapter 8 Command Definitions SP-Z TUNE TUNE Changes scheduling characteristics of the scheduling subqueues . These characteristics include base and limit priorities , quantum bounds (min and max), boost property and timeslice. (Native Mode) Syntax TUNE [ minclockcycle ] { ;CQ= qinfo ;DQ= qinfo ;EQ= qinfo } [ ... ] Where qinfo is written in th[...]

Chapter 8 685 Command Definitions SP-Z TUNE OSCILLATE Sets the subqueue to oscillate behavior . If set, a process returns to the base priority once its priority has decayed to the limit of the subqueue, even if it has not completed a Dispatcher transaction. tslice The number of milliseconds a process in a given subqueue can hold the CPU . A proces[...]

686 Chapter 8 Command Definitions SP-Z TUNE max: 2000 max: 2000 max: 2000 boost: DECAY boost: DECAY boost: DECAY tslice: 200 tslice: 200 tslice: 200 NO TE The MPE/iX Scheduler now supports the workgroup concept. However , backw ard compatibility is maintained through five default workgroups created by the system. The scheduling characteristics of[...]

Chapter 8 687 Command Definitions SP-Z UP UP Returns a particular device to its normal function on the system; cancels any DOWN command issued for the device. This command does not apply to disk drives . Syntax UP ldev P arameters ldev The logical device number of the device being returned to service online. Operation Notes This command makes avai[...]

688 Chapter 8 Command Definitions SP-Z VMOUNT VMOUNT Enables or disables the MPE/iX movable volume facility . (Native Mode) Syntax VMOUNT { ON [ ,A UTO] OFF } [ ;ALL,] P arameters ON or ON,AUTO Enables the movable volume facility so that all valid user MOUNT/VSRESERVE and operator LMOUNT/VSRESERVESYS requests are allowed. When ON is used without A[...]

Chapter 8 689 Command Definitions SP-Z VMOUNT Examples T o disable the movable volume facility so that no messages are sent to the console when users attempt to reserve volume sets (the default condition) enter: VMOUNT OFF T o disable the movable volume facility and still receive messages on the console when users attempt to reserve volume sets , [...]

690 Chapter 8 Command Definitions SP-Z VSCLOSE VSCLOSE Informs the system to close the specified volume set and take it offline . (Native Mode) Syntax VSCLOSE volumesetname [ [ ;P ARTVS=] { USER BACKUP } ] [ ;NOW ;SPLIT ] P arameters volume- setname The volume set that is to be closed. Any user who is accessing a file at the time this command i[...]

Chapter 8 691 Command Definitions SP-Z VSCLOSE F or each mirrored pair , the system assigns a backup volume and user volume. An attempt is made to place the bac kup volumes and user volumes on separate hardware c hannels. The volume with the greatest path number is selected as the backup volume . If SPLIT is specified for a nonmirrored volume set[...]

692 Chapter 8 Command Definitions SP-Z VSCLOSE Examples T o close the volume set ACCOUNTING_PAYROLL , enter: VSCLOSE ACCOUNTING_PAYROLL However , if a VSRESERVESYS command has been issued for ACCOUNTING_PAYROLL , then a message is displayed on the console . In order to close this volume set and take it offline, the operator has to issue these com[...]

Chapter 8 693 Command Definitions SP-Z VSOPEN VSOPEN Reopens a volume set that has been closed with VSCLOSE . The volume set becomes available for use again. (Native Mode) Syntax >VSOPEN volumesetname [ [ ;P ARTVS=] { USER BACKUP } ] P arameters volume- setname The volume set to be opened. Y ou must specify an unambiguous name. MPE/iX does not [...]

694 Chapter 8 Command Definitions SP-Z VSOPEN Vcommand A.B.C Entering Vcommand A fails to access the volume set. Y ou cannot specify the first part of the volume set name alone and expect the group and account to default. Use This command may be issued from a session, job , program, or in BREAK. Pressing Break has no effect on this command. This [...]

Chapter 8 695 Command Definitions SP-Z VSRELEASE VSRELEASE Releases a volume set that was explicitly reserved by the user with VSRESERVE . The equivalent compatibility mode command is DISMOUNT . (Native Mode) Syntax VSRELEASE [ volumesetname ] P arameters volume- setname The volume set to be released. If you omit the parameter , the request is iss[...]

696 Chapter 8 Command Definitions SP-Z VSRELEASE Example T o request that volume set ACCOUNTING_PAYROLL be released, enter: VSRELEASE ACCOUNTING_PAYROLL Related Information Commands The VSxxxxxx commands in this chapter , DISMOUNT Manuals V olume Management Reference Manual[...]

Chapter 8 697 Command Definitions SP-Z VSRELEASESYS VSRELEASESYS Releases a specified volume set previously reserved with the VSRESERVESYS command. The equivalent compatibility mode command is LDISMOUNT . (Native Mode) Syntax VSRELEASESYS volumesetname P arameters volume- setname The name of the MPE/iX volume set for which a previously issued VSR[...]

698 Chapter 8 Command Definitions SP-Z VSRESER VE VSRESERVE Notifies the system to keep a particular volume set online. The equivalent compatibility mode command is MOUNT . (Native Mode) Syntax >VSRESERVE [ volumesetname ] [ ;GEN= geninde x ] P arameters volume- setname The name of the MPE/iX volume set to be kept online. If you omit the param[...]

Chapter 8 699 Command Definitions SP-Z VSRESER VE Use This command may be issued from a session, job , program, or in BREAK. Pressing Break has no effect on this command. Use volumes (UV) or create volumes (CV) capability is required to use this command. Example T o request that volume set ACCOUNTING_PAYROLL be kept online, enter: VSRESERVE ACCOUN[...]

700 Chapter 8 Command Definitions SP-Z VSRESER VESYS VSRESERVESYS Instructs the system to reserve a volume set online system-wide. The equivalent compatibility mode command is LMOUNT . (Native Mode) Syntax VSRESERVESYS volumesetname P arameters volume- setname The name of the MPE/iX volume set to be kept online. Operation Notes This command calls [...]

Chapter 8 701 Command Definitions SP-Z VST ORE VSTORE V erifies that the data on a backup media are valid (for example , there are no media errors), and reports any errors incurred by STORE when creating the backup. Syntax VSTORE [ vstor efile ][; filesetlist ][ ; option [ ;... ] ] where option is: [ ;SHOW [ = showparmlist ]] [ ;ONERROR= { QUIT[...]

702 Chapter 8 Command Definitions SP-Z VST ORE If vstor efile is not supplied and the RESTORESET option is not used, then VSTORE creates a default file name. The default file name is the user's logon username. No file equation is used. Sequential and parallel devices are specified with the RESTORESET option. Similarly , magneto-optical d[...]

Chapter 8 703 Command Definitions SP-Z VST ORE filestovstor e filestoexclude Both filesto vstor e and filestoexclude ma y be entered in MPE or HFS syntax. Wildcards are permitted for both MPE and HFS syntax. The MPE syntax is as follows: filename [. gr oupname [. accountname ] A lockword may be specified for files to be verified, in the fo[...]

704 Chapter 8 Command Definitions SP-Z VST ORE ?n@ V erify all files whose second character is n . n? store all two-character files starting with the character n . ?n V erify all two-character files ending with the character n . Also, c haracter sets may be specified in the following syntax: [ct] specifies letter c or t . [c-t] specifies any[...]

Chapter 8 705 Command Definitions SP-Z VST ORE file.gr oup.acct/ACCT /GR OUP/FILE ' One particular file in one particular group in one particular account. file.gr oup/LOGON- A CCT/GR OUP/ FILE One particular file in one particular group in the logon account. file ./FILE One particular file in the logon group and account. @.gr oup.acct /[...]

706 Chapter 8 Command Definitions SP-Z VST ORE NO TE If an HFS-named file is specified in the filesetlist , or the expansion of a wildcard includes an HFS-named file , then an HFS-style output listing will be used. This listing shows the same information as the MPE format, but puts the name of the file at the right end of the listing , to all[...]

Chapter 8 707 Command Definitions SP-Z VST ORE PROGRESS Instructs VSTORE to report its progress at regular intervals by displaying the message VSTORE OPERATION IS nnn% COMPLETE . F or interactive users , this message is displayed on $STDLIST . F or jobs , this message is sent to the system console. minutes A positive number specifying the number o[...]

708 Chapter 8 Command Definitions SP-Z VST ORE Consecutive tapes are specified in the following wa y: < user ;RESTORESET = (* tape1 ,* tape2 ,* ta pe3 ,...) This instructs MPE/iX to use only one drive at a time for the vstore operation. When the first reel of tape is exhausted, VSTORE will shift to the next available drive , leaving the firs[...]

Chapter 8 709 Command Definitions SP-Z VST ORE backupname A three field name of a total maximum length of 26 c haracters . The format is fname.gname .aname . The name represents the "handle" to this particular backup and can is used to retrieve files from this backup . The fname , gname and aname can be up to 8 alphanumeric characters [...]

710 Chapter 8 Command Definitions SP-Z VSUSER VSUSER Displays all users of a currently reserved, mountable volume set. (Native Mode) Syntax VSUSER [ volumesetname ] P arameter volume- setname A fully qualified volume set name. Default is that information for all currently reserved volume sets is displayed. Operation Notes The VSUSER command lists[...]

Chapter 8 711 Command Definitions SP-Z W ARN W ARN Sends an urgent message to jobs/sessions . Syntax WARN { @[# ] J nnn [# ] S nnn [ jsname ,] user .acct }[; message ] P arameters @ All users receive the message (including those running in QUIET mode). #J nnn A job number (assigned by MPE/iX) for the job that is to receive the message. #S nnn A se[...]

712 Chapter 8 Command Definitions SP-Z W ARN Example T o 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;LAST CHANCE TO LOG OFF GRACEFULLY. Related Information Commands TELL , TELLOP Manuals P erforming System Operation T asks[...]

Chapter 8 713 Command Definitions SP-Z WELCOME WELCOME Defines the welcome message. Syntax WELCOME [ welcfile ] P arameters welcfile An ASCII file containing the welcome message. Operation Notes The operator uses the WELCOME command to compose the message that is transmitted to users when they initiate jobs and sessions . The message is retain[...]

714 Chapter 8 Command Definitions SP-Z WELCOME Related Information Commands HELLO , SHOWME Manuals P erforming System Operation T asks[...]

Chapter 8 715 Command Definitions SP-Z WHILE WHILE Used to control the execution sequence of a job, session, UDC , or command file. (Native Mode) Syntax WHILE expr ession [ DO] P arameters expression Logical expression, consisting of operands and relational operators . T able 8-1 lists the operators that may be incorporated in expression . T able[...]

716 Chapter 8 Command Definitions SP-Z WHILE Nesting of IF and WHILE blocks is limited to a combined total of 30 levels. Each IF or WHILE block read by the Command Interpreter increments the nesting count by 1. NO TE Y ou may not write a WHILE construct in such a w ay that it physically crosses from one user command (UDCs or command files) to ano[...]

Chapter 8 717 Command Definitions SP-Z XEQ XEQ Executes any program or command file. Its value lies in preventing any possible confusion when the name of the program or command file you want to execute is identical to the name of a built-in MPE/iX command or UDC command name. (Native Mode) Syntax XEQ filename [ parameterlist ]* or XEQ filename[...]

718 Chapter 8 Command Definitions SP-Z XEQ Because FCOPY references an existing , built-in MPE/iX command, failing to use XEQ results in running FCOPY . That happens because FCOPY is found in the command directory and is executed, and the command search terminates . XEQ follows the same searching logic used for command files and implied RUN . Rel[...]

Appendix A 719 Predefined V ar iables in MPE/iX A Predefined V ariables in MPE/iX Many variables have been predefined for use by the command interpreter . They may be used anywhere you would use your own variables . T able A-1 lists all valid predefined variables . T able A-1 Predefined V ariables V ariable Type a Definition Initial V alue CI[...]

720 Appendix A Predefined V ar iables in MPE/iX HPCPUMSECS R I from root CI = current session CPU-time in milliseconds; from other CI or process = current process CPU-time in milliseconds zero HPCPUSECS R I from root CI = current session CPU-time in seconds; from other CI or process = current process CPU-time in seconds zero HPCWD R S current work[...]

Appendix A 721 Predefined V ar iables in MPE/iX HPINTERACTIVE R B PL interactive (TRUE); noninteractive (F ALSE) as appropriate HPINTRODATE R S formatted job/session logon date date of logon HPINTROTIME R S formatted job/session logon time time of logon HPJOBCOUNT R I number of jobs executing logon number of executing jobs HPJOBFENCE R I fence val[...]

722 Appendix A Predefined V ar iables in MPE/iX HPOUTFENCE R I output fence value logon output fence value HPPATH W S search path for command files and implied RUN "!HPGROUP,PUB,P UB.SYS, ARPA.SYS" HPPIN R I Process Identification Number for the executing process PIN for the root CI HPPROMPT W S CI's prompt string " : " [...]

Appendix A 723 Predefined V ar iables in MPE/iX HPSUSAN R I unique serial number assigned at the factory to each system for use by softw are unique serial number assigned to your system at manufacture HPSUSPJOBS R I current number of jobs in SUSP state (suspended) numbers of jobs in SUSP state at logon HPSYSNAME W S name of computer system (user -[...]

724 Appendix A Predefined V ar iables in MPE/iX If a PL variable is changed by a process it returns to its original value when the process terminates . F or example , if you logon and set HPREDOSIZE (the number of entries in the CI's redo stack) to 25 and then run a program which sets it to 30 (using the COMMAND or HPCICOMMAND intrinsics) the[...]

Appendix B 725 Expression Evaluator Functions B Expression Evaluator Functions The expression evaluator is a system procedure used by the user interface to accept a string , number , or Boolean expression, evaluate it, and return the result. This procedure is used by the CALC , SETVAR , IF , ELSEIF , and WHILE commands and within a ![ ].. The expre[...]

726 Appendix B Expression Evaluator Functions T able B-1 Expression Evaluator Functions Symbol Function Example Result +(numeric) addition 4 + 5 9 +(string) concatenate “abc‘ + “de‘ abcde -(numeric) subtraction 12 - 6 6 -(string) deletion of first occurrence “abc‘ - “b‘ ac * multiplication 4 * 5 20 / integer division 79/ 10 7 ˆ ex[...]

Appendix B 727 Expression Evaluator Functions BASENAME ( string ) returns the filename component CALC basename (‘a.b.c’) CALC basename (‘/a/b/c’) CALC basename (’./a/b’) CALC basename (“./a.sl”, ”.sl”) CALC basename (‘/’) CALC basename (“*feq”) CALC basename (‘$null’) CALC basename (‘abc.g’, ’c’) CALC basena[...]

728 Appendix B Expression Evaluator Functions DELIMPOS ( str , [, delims ] [, nth ][, start ]) returns index in str of the nth delimiter beginning at start ; default delims are a space, a comma, a semicolon, an equals sign, left and right parentheses, left and right brackets , single quote, double quote, and T ab; default nth is 1; default start is[...]

Appendix B 729 Expression Evaluator Functions FQU ALIFY( string ) returns a fully qualified filename CALC fqualify(‘a’) CALC fqualify(‘a.b’) CALC fqualify(‘a.b .c’) CALC fqualify(‘./a’) CALC fqualify(‘./A ’) CALC fqualify(‘/a/b/c’) CALC fqualify(‘*a’) CALC fqualify(‘$null’) CALC dirname (fqualify(‘./a’)) A.GROU[...]

730 Appendix B Expression Evaluator Functions NOT logical not not(2>1) F ALSE NUMERIC ( string ) chec k if a string is all digits numeric('12345') numeric('$a234ef') TRUE F ALSE OCTAL( inte ger ) convert to octal string octal(329) %511 ODD(integer) determine if integer is odd odd(233) odd(-2) TRUE F ALSE OR logical or 5=5 or [...]

Appendix B 731 Expression Evaluator Functions REPL( str ,oldstr ,newstr [, cnt ][, start ]) in a given string ( str ), replaces cnt occurrences of oldstr with newstr , beginning at start ; if cnt is positive, replacement begins at the left end of str ; if negative, replacement begins at the right end of str ; default start is 1; default cnt is zero[...]

732 Appendix B Expression Evaluator Functions WORD( string, [, delims ] [, nth ][, end_var ][, start ]) performs general word extraction; default delims are a space, a comma, a semicolon, an equals sign, left and right parentheses, left and right brackets , single quote, double quote, and T ab; default nth is 1; the default end_var is no variable; [...]

Appendix B 733 Expression Evaluator Functions References References The following references apply to the numbers that appear in parentheses in table B-1. 1. Special rules apply when you use the comparison operators with strings. The strings are compared, character by character , until an inequality is found. This becomes the inequality of the stri[...]

734 Appendix B Expression Evaluator Functions References 6. The FINFO function returns a string, Boolean, or an integer value . The result depends upon the option specified. The first parameter , filename , is a string, the name of the file for which you w ant the information. This must be a fully or partly qualified file name, or a string ex[...]

Appendix B 735 Expression Evaluator Functions References comment side of the AND is FALSE and so comment the right side is not executed. This comment means no INPUT() will be performed. F or L TRIM and RTRIM if trimstr is not given, then a space is used as the default POS ( findstr ,sour cestr [, N ]). If N is specified, the Nth occurrence of fi[...]

736 Appendix B Expression Evaluator Functions References 7 ACCESSED FMTACCESSED LAST ACCESS DATE String Last access date -7 LAST ACCESS DATE INTEGER INTACCESSED Integer Last access date 8 MODIFIED LAST MOD DATE FMTMODDATE String Last modification date -8 LAST MOD DATE INTEGER INTMODDATE Integer Last modification date 9 FILE CODE MNEMONIC FMTFCODE[...]

Appendix B 737 Expression Evaluator Functions References 24 FMTMODTIME LAST MOD TIME String Last modification time -24 INTMODTIME LAST MOD TIME Integer Last modification time 25 FIRST USER LABEL String First user label (user label 0) 27 UNIQUE FILE ID UFID String Unique file identifier (UFID) 28 BYTE FILE SIZE BYTEFILESIZE Integer T otal number[...]

738 Appendix B Expression Evaluator Functions References 43 FILE OWNER NAME OWNER String File owner 44 FILE OWNER ID UID Integer File owner identifier 45 FILE GROUP NAME FILEGROUP String File group 46 FILE GROUP ID GID Integer File group identifier 47 FILE TYPE FILETYPE String File type -47 FILE TYPE INTEGER INTFILETYPE Integer File type 48 RECOR[...]

Appendix B 739 Expression Evaluator Functions Expression Evaluator Features Expression Evaluator F eatures The two main types of expressions , which can be processed by the expression evaluator , are numeric and string . In addition, Boolean expressions may be constructed using numeric and string expressions (involving the comparison operators), Bo[...]

740 Appendix B Expression Evaluator Functions Expression Evaluator Features Functions may be nested and mixed. String , numeric, and Boolean operations ma y not, however , be mixed. F or example: calc 1+'abc' ERROR calc 'a' +len('abc') ERROR if bound(a) + 3>2 then ERROR setvar bool1 true if bool1 and (str('abc&[...]

Appendix B 741 Expression Evaluator Functions Expression Evaluator Features a+b*c/d calc !exp 2, $2, %2 setvar exp2 exp+'*e' calc !exp2 6,$6,%6 setvar a hptimef showvar a A = 8:26 AM ** the time when var was set ** calc a + 'in the morning!!! ' 8:26 AM in the morning!!!' calc 'a' + 'in the morning!!!' a [...]

742 Appendix B Expression Evaluator Functions Expression Evaluator Features • Logical operations: AND , NOT • Logical operations: OR, XOR The evaluation of string expressions follows a similar hierarchy . However , bit manipulation, multiplication, division, and modulo operations do not apply to string expressions . If you attempt to use them w[...]

Appendix B 743 Expression Evaluator Functions Expression Evaluator Features If a string is expected and a valid quoted string is not found, variable management is called to determine if the token is a variable. If it is not a variable , an error is returned. If it is a variable containing a string value, its contents is used in the expression. If t[...]

744 Appendix B Expression Evaluator Functions Expression Evaluator Features ABX SETVAR Z “foo‘ CALC “AB‘ + Z ABfoo CALC “AB‘ + “!Z‘ ABfoo CALC “AB‘ + !Z error variable foo not found SETVAR A “X‘+“Y‘ CALC A +“B‘ XYB CALC “!HPTIMEF‘ 8:26 AM CALC HPTIMEF 8:26 AM CALC !HPTIMEF error The error in the last example occu[...]

Appendix B 745 Expression Evaluator Functions Expression Evaluator Features CALC !A + 2 works . !A is really !B . That in turn yields a value of 2 . The result is 2 + 2 , which equals 4 . CALC “HPTIMEF‘ HPTIMEF But, CALC !HPTIMEF CALC 8:26 AM which produces an error . On the other hand, CALC “!HPTIMEF‘ is the same as CALC “8:26 AM‘ whic[...]

746 Appendix B Expression Evaluator Functions Expression Evaluator Features[...]

Appendix C 747 T er minal and Printer T ypes C T erminal and Printer Types The terminal types supported on the advanced terminal processor (ATP) and asynchronous data communications controller (ADCC) terminal/printer controllers for MPE V/E T -MIT or later (MPE V/E version G .01.00 or later) are 6, 9, 10, 12, 13, 15, 16, 18, 19, 20, 21, TTPCL18, TT[...]

748 Appendix C T er minal and Printer T ypes T able C-3 MPE V/E T erminal and Similar MPE/iX T erminal Types T able C-4 MPE V/E T erminal and Similar MPE/iX Printer Types MPE V/ET erminal Description MPE/iX T erminal Comments 6,9 Non-HP hardcopy device needing delays after linefeed or formfeed. None Devices that need delays are not supported on M[...]

Appendix C 749 T er minal and Printer T ypes 20 8-bit Serial spooled printer . 22 Status checking is done less frequently on MPE/iX. The Initialization string is the same as MPE V/E terminal type PCL22. 21 8-bit Serial spooled printer with no status checking after XOFF . 21 Status checking is done less frequently on MPE/iX. Initialization string is[...]

750 Appendix C T er minal and Printer T ypes[...]

Appendix D 751 Subsystem Formal File Designators D Subsystem F ormal F ile Designators T able D-1 lists the formal file designator associated with specific command parameters. T able D-1 F ormal File Designators Command P arameter F ormal File Designator BASIC commandfile BASCOM inputfile BASIN listfile BASLIST BASICOMP textfile BSCTEXT usl?[...]

752 Appendix D Subsystem Formal File Designators CCXL textfile CCTEXT objectfile CCOBJ listfile CCLIST CCXLGO textfile CCTEXT CCXLLK listfile CCLIST COB74XL textfile COBTEXT COB85XL objectfile COBOBJ listfile COBLIST masterfile COBMAST newfile COBNEW workspacename COBWKSP xdbfilename COBXDB COB74XLG textfile COBTEXT COB74XLK listfile C[...]

Appendix D 753 Subsystem Formal File Designators FORTRAN textfile FTNTEXT uslfile FTNUSL listfile FTNLIST masterfile FTNMAST newfile FTNNEW FORTGO textfile FTNTEXT FORTPREP listfile FTNLIST masterfile FTNMAST newfile FTNNEW FTN textfile FTNTEXT uslfile FTNUSL listfile FTNLIST FTNGO textfile FTNTEXT FTNXLGO listfile FTNLIST FTNPREP tex[...]

754 Appendix D Subsystem Formal File Designators listfile PASLIST libfile PASLIB PASXLGO textfile PASTEXT PASXLLK listfile PASLIST libfile PASLIB PREP PMAP SEGLIST PREPRUN LMAP LOADLIST RESTORE SHOW SYSLIST RPG textfile RPGTEXT uslfile RPGUSL listfile RPGLIST masterfile RPGMAST newfile RPGNEW RPGGO textfile RPGTEXT RPGPREP listfile RPGL[...]

Appendix D 755 Subsystem Formal File Designators masterfile SPLMAST newfile SPLNEW STORE SHOW SYSLIST RESTORE SYSGEN inputfile SYSGIN outputfile SYSGOUT Command P arameter F ormal File Designator[...]

756 Appendix D Subsystem Formal File Designators[...]

Appendix E 757 MPE/iX File Codes E MPE/iX F ile Codes File codes are recorded in the file label and are available to processes accessing the file through the FFILEINFO or FGETINFO intrinsic. Although any user can specify a positive integer ranging from 0 to 32767 or the mnemonic name for this parameter , certain reserved integers and mnemonics ha[...]

758 Appendix E MPE/iX File Codes 1059 TDPXQ TDP W ork File (COBOL) 1060 RJEPN RJE Punch File 1070 QPROC QUERY Procedure File 1080 KSAMK KSAM K ey File 1083 GRAPH GRAPH Specification File 1084 SD Self-describing File 1090 LOG User Logging Log F ile 1100 WDOC HPWORD Document 1101 WDICT HPWORD Hyphenation Dictionary 1102 WCONF HPWORD Configuration F[...]

Appendix E 759 MPE/iX File Codes 1156 DSTOR RAPID/3000 DICTDBU Utility Store File 1157 TCODE Code File for Transact/3000 Compiler 1158 RCODE Code File for Report/3000 Compiler 1159 ICODE Code File for Inform/3000 Compiler 1166 MDIST HPDESK Distribution List 1167 MTEXT HPDESK T ext 1168 MARP A ARP A Messages File 1169 MARPD ARP A Distribution List 1[...]

760 Appendix E MPE/iX File Codes 1228 LANGD Language Definition File 1229 CHARD Character Set Definition File 1230 MGC AT F ormatted Application Message Catalog 1236 BMAP Base Map Specification File 1242 BDA TA HP Business BASIC/V Data File 1243 BFORM HP Business B ASIC/V Field Order File for VPLUS 1244 BSA VE HP Business BASIC/V SA VE Program F[...]

Appendix E 761 MPE/iX File Codes NO TE Default is the unreserved file code of 0. 1435 PRINT BRW Print File 1436 RCONF BRW Configuration File 1437 RDICN BRW NM Dictionary File 1438 REXNUM BRW NM Execution File 1441 PIF Reserved 1476 TIFF T ag Image File F ormat 1477 RDF Revisable Document F ormat 1478 SOF Serial Object File 1479 GPF Chart File for[...]

762 Appendix E MPE/iX File Codes Using 1090 (LOG) as a designated file code may not yield the number of records you specify in the DISC= parameter . Most files use the number of records specified in the DISC= parameter as the maximum limit; user logging uses this specified number as a minimum.[...]

Appendix F 763 Wildcard Characters F W ildcard Characters In some commands , you may substitute wildcard characters for certain parameters , or parts of parameters , in the list. The wildcard characters count toward the eight character limit for user , group, account, and file names . These wildcard characters are defined in T able F-1. T able F-[...]

764 Appendix F Wildcard Characters[...]

Index Index 765 Symbols $NEWP ASS , 234 $NULL , 234 $OLDP ASS , 234 $STDIN , 234 $STDLIST , 234 =LOGOFF command , 371 =LOGON command , 373 =SHUTDOWN command , 607 A ABORT command , 38 aborting jobs/sessions , 41 , 371 pending I/O requests , 39 programs/operations , 38 ABORTIO command , 39 ABORTJOB command , 41 ACCEPT command , 43 access control de?[...]

766 Index Index groups within an account , 137 job attributes , 62 log files , 677 log files automatically , 131 logging files , 131 user attributes , 79 user capabilities , 79 user logging identifier attributes , 64 changing a process , 66 changing characters command lines , 466 CHDIR command , 134 CHGROUP command , 137 CIR files , 240 circul[...]

Index Index 767 directories , 382 files , 112 groups , 384 installation tape , 679 job control words , 558 job queues , 388 log identifiers , 275 new link , 389 program files , 216 prompt strings , 294 sessions on a device , 639 text files , 216 users , 387 variables , 564 welcome messages , 713 D data disabling , 471 , 673 enabling , 673 spool[...]

768 Index Index subsystem , 216 editing command lines , 201 , 465 files , 216 EDITOR command , 216 ELSE command , 217 ELSEIF command , 218 enabling echoing , 214 , 542 jobs/data , 673 jobs/sessions , 373 messages , 542 , 563 movable volume facility , 688 RPS devices , 189 end of file denoting , 222 ENDIF command , 220 ending batch jobs , 224 sess[...]

Index Index 769 getting information online , 287 global RINs releasing , 261 global RINs, acquiring , 277 granting access to operator commands , 47 group passwords , 384 switching to another , 137 group library , 438 group-related commands , 16 groups changing attributes , 57 changing to another group , 137 creating , 384 deleting , 457 displaying [...]

770 Index Index logging identifiers creating , 275 displaying , 351 user , 275 logging off , 119 logging on , 281 jobs , 297 logical device numbers displaying , 588 logical shift operator , 733 logon groups , 284 L TRIM function , 735 M magnetic tape restoring files from , 486 storing files on , 649 main memory , allocating , 45 master installat[...]

Index Index 771 SPL/V programs , 617 , 619 PREPRUN command , 437 PRINT command , 442 print output redirecting , 442 printer types , 747 printers configuring , 250 printing changing priority , 77 files , 442 priority , 410 symbol maps , 315 priority altering for a process , 66 printing , 410 priority queues jobs , 300 private volumes naming , 198 [...]

772 Index Index RTRIM function , 735 RUN command , 522 implied , 533 S SA VE command , 536 saving permanent files , 536 temporary files , 536 scheduling jobs , 669 searching libraries , 532 SECURE command , 538 access control definition , 538 checking the file status , 538 examples , 539 security files , 538 in jobs , 306 provisions, removing [...]

Index Index 773 suspended operation resuming , 501 suspending jobs , 111 output , 675 system activity , 428 SUSPENDSPOOL command , 675 switching from group to group , 137 SWITCHLOG command , 677 symbol maps printing , 315 symbolic debugger , 140 , 150 syntax command , 27 SYSGEN command , 679 system logging , 351 system activity suspending , 428 sys[...]

774 Index Index system-wide , 700 taking offline , 690 volume-related commands , 21 VSCLOSE command , 690 VSOPEN command , 693 VSRELEASE command , 695 VSRELEASESYS command , 697 VSRESERVE command , 698 VSRESERVESYS command , 700 VSTORE command , 701 VSUSER command , 710 W W ARN command , 711 WELCOME command , 713 welcome messages, creating , 713 W[...]