home *** CD-ROM | disk | FTP | other *** search
/ The Hacker's Encyclopedia 1998 / hackers_encyclopedia.iso / zines / phrack1 / phrack27.002 < prev    next >
Encoding:
Text File  |  2003-06-11  |  37.4 KB  |  823 lines

  1.  
  2.                                 ==Phrack Inc.==
  3.  
  4.                      Volume Three, Issue 27, File 2 of 12
  5.  
  6.  
  7.                           Operating the IBM VM/SP CP
  8.  
  9.              (IBM Virtual Machine System Product Control Program)
  10.  
  11.                      An information article researched by
  12.  
  13.                                   Taran King
  14.  
  15.                                  May 18, 1989
  16.  
  17.  
  18. This article is for the purpose of understanding the Control Program (CP)
  19. portion of IBM's VM/SP.  This is basically a separate section of VM/CMS known
  20. as CP (with full screen editors, the CP level is indicated in the lower right
  21. hand corner of the screen and for line-by-line editors, before the command line
  22. and after hitting carriage returns, it should say "CP") and it's purpose is to
  23. manage real resources.  Any command that involves something outside of your
  24. virtual machine must communicate with CP.  If CMS does not recognize a command
  25. you give it, it will give it to CP.
  26.  
  27. The user generally enters the CP stage after a program flops or if you get
  28. disconnected.  You can also enter the CP stage by hitting PA1 which is a
  29. function key of sorts.  PA1 toggles between CP and CMS while on-line and if you
  30. re-login after being disconnected, PA1 can be used besides the BEGIN command
  31. which will be spoken about later in this article.
  32.  
  33. Generally, VM/CMS systems are well equipped with help files so if anything I
  34. print becomes unclear to you, from CMS mode, type HELP CP XXX where XXX is the
  35. CP command you want information on.
  36.  
  37. To start this article off, I'm printing off the IBM-Defined Class and the
  38. Function Types as listed in the IBM VM/SP CP manual.  This essentially tells
  39. you what privileges you have with your assigned class.
  40.  
  41. ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  42. IBM-Defined      Function         User &
  43.    Class           Type          Functions
  44. ~~~~~~~~~~~      ~~~~~~~~        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  45.      A               O           Operations:  The primary sysop can issue all
  46.                                  class A commands.  The class A user controls
  47.                                  the VM/SP system.  Class A is assigned to the
  48.                                  user at the VM/SP system console during IPL.
  49.                                  The primary sysop is responsible for the
  50.                                  availability of the VM/SP system and its
  51.                                  communication lines and resources.  In
  52.                                  addition, the class A user controls system
  53.                                  accounting, broadcast messages, virtual
  54.                                  machine performance options, and other
  55.                                  command operands that affect the overall
  56.                                  performance of the VM/SP.  The sysop controls
  57.                                  operation of the real machine using the
  58.                                  system control panel and console device.
  59.                                  NOTE:  The class A sysop who is automatically
  60.                                  logged on during CP initialization is
  61.                                  designated as the primary sysop.
  62.  
  63.      B               R           Resource:  The system resource operator can
  64.                                  issue all class B commands.  The class B user
  65.                                  controls allocation and deallocation of all
  66.                                  the real resources of the VM/SP system,
  67.                                  except those controlled by the primary sysop
  68.                                  and spooling operator.
  69.  
  70.      C               P           Programmer:  The system programmer can issue
  71.                                  all class C commands.  The class C user
  72.                                  updates certain functions of the VM/SP
  73.                                  system.  The system programmer can modify
  74.                                  real storage in the real machine.
  75.  
  76.      D               S           Spooling:  The spooling operator can issue
  77.                                  all class D commands.  The class D user
  78.                                  controls spool data files and specific
  79.                                  functions of the system's unit record
  80.                                  equipment.
  81.  
  82.      E               A           Analyst:  The system analyst can issue all
  83.                                  class E commands.  The class E user displays
  84.                                  the contents of real storage, performs the
  85.                                  functions required to generate saved systems
  86.                                  and discontiguous saved segments, and
  87.                                  controls the collecting and recording of
  88.                                  performance measurement data.  This class of
  89.                                  user can display specified real storage areas
  90.                                  on the virtual operator's console or on a
  91.                                  spooled virtual printer, but cannot modify
  92.                                  real storage.
  93.  
  94.      F               C           Customer Engineer:  The service
  95.                                  representative can issue all class F
  96.                                  commands.  The class F user obtains, and
  97.                                  examines, in detail, certain data about input
  98.                                  and output devices connected to the VM/SP
  99.                                  system.  The service representative can
  100.                                  establish extensive recording mode for one
  101.                                  I/O device at a time and can cause the
  102.                                  recording of repressible machine check errors
  103.                                  to be initiated or resumed.
  104.  
  105.      G               G           General:  The general user can issue all
  106.                                  class G commands.  The class G user controls
  107.                                  functions associated with the execution of
  108.                                  his virtual machine.  A general user cannot
  109.                                  display or modify real storage.
  110.  
  111.     ANY             ANY          The ANY classification is given to certain CP
  112.                                  commands that are available to any user.
  113.                                  These are primarily for the purpose of
  114.                                  gaining and relinquishing access to the VM/SP
  115.                                  system.
  116.  
  117. ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  118.  
  119. The following is the list of commands available along with a brief description
  120. as to what they do and/or formatting and then ending with the IBM-Defined
  121. Class and Function Type.
  122.  
  123. * : From CP, one may use the * command to annotate the terminal console sheet
  124. ~   or the terminal display screen with a comment.  In other words, type * and
  125. then any string of characters you would, for some reason, to be present on the
  126. screen thereafter.
  127. Privilege Class:  ANY
  128. Function Type:  N/A
  129.  
  130. #CP : This command is used to execute a CP Command while in a virtual machine
  131. ~~~   command environment without first signaling attention to get to the CP
  132. command environment which means that when typing P <command> to perform a CP
  133. operation, CP directly receives the command whereas CP <command> merely queues
  134. the command from CP.
  135. Privilege Class:  ANY
  136. Function Type:  ANY
  137.  
  138. ACNT : The ACNT command is used to create accounting records for logged on
  139. ~~~~   users and to reset accounting data.  It also closes a spool file that
  140. is accumulating accounting records.
  141. Privilege Class:  A
  142. Function Type:  O
  143.  
  144. ADSTOP : The ADSTOP command is used to halt the execution of a virtual machine
  145. ~~~~~~   at a virtual instruction point.  The hexloc variable may be placed
  146. after the word ADSTOP which is a 6 character hexadecimal representation of the
  147. virtual instruction address where the execution is to be halted.  The OFF
  148. option of the ADSTOP command cancels any previous ADSTOP setting.
  149. Privilege Class:  G
  150. Function Type:  G
  151.  
  152. ATTN : Use the ATTN command to make an attention interruption pending at your
  153. ~~~~   virtual console.
  154. Privilege Class:  G
  155. Function Type:  G
  156.  
  157. AUTOLOG : This command allows the user to log on any virtual machine defined
  158. ~~~~~~~   in the directory.
  159. Privilege Level:  A, B
  160. Function Type:  O
  161.  
  162. BACKSPAC : The BACKSPAC command is used to restart or reposition the current
  163. ~~~~~~~~   output on a real punch or printer.
  164. Privilege Class:  D
  165. Function Type:  S
  166.  
  167. BEGIN or B : The BEGIN command by itself from CP mode will return the user to
  168. ~~~~~~~~~~   CMS mode in the place where he/she left off before he/she was
  169. disconnected or thrown into CP.  The BEGIN command can also be followed by a
  170. hex location as to where to start in the case of the user wanting to be doing
  171. something other than what was previously occurring.
  172. Privilege Class:  G
  173. Function Type:  G
  174.  
  175. CHANGE or CH : In use of the CHANGE command, there are subcommands with
  176. ~~~~~~~~~~~~   variables.  Generally, the "name" variable is 1 to 4 characters
  177. in length.  The following are the subcommands with functions and formatting:
  178.  
  179.   o  READER or RDR : changes reader spool files.
  180.   o  PRINTER or PRT : changes printer spool files.
  181.   o  PUNCH or PCH : changes punch spool files.
  182.   o  CLASS c1 : designates an existing class where c1 is a 1-character
  183.                 alphanumerical field from A to Z or 0 to 9.
  184.   o  spoolid : spoolid number of file that is to be changed.
  185.   o  FORM form1 : 1 to 8 character alphanumeric form name used to select files
  186.                   to be changed (form1).
  187.   o  ALL : changes all of your spool files.
  188.   o  HOLD : prevents a file from being printed, punched, or read until
  189.             released.
  190.   o  NOHOLD : releases the specified file from the user's HOLD status.
  191.   o  DIST dist : changes the distribution code to variable "dist".
  192.   o  COPY(*)nnn : specifies number of copies of the file you want spooled,
  193.                   which is valid only for printer or punch files.  "nnn" is a
  194.                   number from 1 to 255 and the "*" is  present in the case of
  195.                   a 3800 printer being used so that copies will be made in the
  196.                   printer internally.
  197.   o  FLASH name nnn : signifies that a form's overlay contained in the 3800
  198.                       printer is to be superimposed onto certain pages of
  199.                       output.  "nnn" is a number from 0 to 255 representing
  200.                       the number of copies to be superimposed.
  201.   o  MODIFY name (n) : allows text alteration by preventing information
  202.                        printing or by adding labels to output.  "n" selects a
  203.                        keyword in CHARS to be used for copy modification text.
  204.   o  CHARS name1 (name2(name3(name4)))
  205.      CHARS name1(CH names2(CH names3(CH names4))) : specifies character
  206.                        arrangement table when printing a file.  There can be
  207.                        up to 4 names.
  208.   o  FCB name : controls vertical spacing of output on a page.
  209.   o  FORM form2 : changes spool form name of file to form2.
  210.   o  NAME fn (ft) : assigns identification to spool file in CMS format
  211.                     filename and filetype.
  212.   o  NAME dsname : assigns identification to spool file in non-CMS format
  213.                    where "dsname" is from 1 to 24 characters, suitable for
  214.                    specifying OS or DOS files.
  215. Privilege Class:  S, G
  216. Function Type:  D, G
  217.  
  218. CLOSE or C : The CLOSE command terminates spooling activity on any virtual
  219. ~~~~~~~~~~   spooled unit record or console device.  It Contains the following
  220. subcommands to be followed by the letter C or the word CLOSE:
  221.  
  222.    o  READER or RDR
  223.    o  PRINTER or PRT
  224.    o  PUNCH or PCH
  225.    o  FORM form1
  226.    o  HOLD
  227.    o  NOHOLD
  228.    o  DIST dist
  229.    o  NAME fn (ft)
  230.    o  NAME dsname
  231.    o  vaddr : virtual address (cuu) of device to be closed.
  232.    o  CONSOLE : closes virtual machine's console spool file which makes it a
  233.                 printer spool file.
  234.    o  PURGE : closes and immediately purges from the virtual machine the
  235.               output spool files.  No output file is produced.
  236.    o  CHAIN : only valid for VM/SP HPO Release 4.2 and Profs Spool File
  237.               Enhancement PRPQ.  Indicates that the punchfile is to be
  238.               chained.
  239. Privilege Class:  G
  240. Function Type:  G
  241.  
  242. COMMANDS or COMM : Use COMMAND to list the commands and diagnose codes you are
  243. ~~~~~~~~~~~~~~~~   authorized to use.
  244. Privilege Class:  ANY
  245. Function Type:  ANY
  246.  
  247. COUPLE : Using the COUPLE command connects your virtual non-dedicated
  248. ~~~~~~   channel-to-channel device to another user's virtual device of the
  249. same type or to another one of your own virtual devices of the same type.  The
  250. format of this command is in the form of COUPLE vaddr1 TO userid vaddr2.  The
  251. variable vaddr1 is your virtual address and the variables userid vaddr2
  252. identify the userid and virtual address of that userid to be connected to.
  253. Privilege Class:  G
  254. Function Type:  G
  255.  
  256. CP : The CP command may precede the command to be processed, but it is not
  257. ~~   necessary.  Generally, the CP command is used from CMS mode to queue CP
  258. functions by typing CP <command>.
  259. Privilege Class:  ANY
  260. Function Type:  ANY
  261.  
  262. CPTRAP : The CPTRAP command creates a reader file of a selected trace table,
  263. ~~~~~~   CP interface, and virtual machine interface entries for problem
  264. determination.
  265. Privilege Class:  C
  266. Function Type:  P
  267.  
  268. DCP : This command displays the contents of real storage locations at the
  269. ~~~   terminal.
  270. Privilege Class:  C, E
  271. Function Type:  P
  272.  
  273. DEFINE or DEF : The DEFINE command in CP is used to alter your virtual machine
  274. ~~~~~~~~~~~~~   configuration or channel operating mode.  There are a LOT of
  275. subcommands that are used with the DEFINE command such as RDR or PRT or PCH
  276. and the list goes on and on.  If you want details, there is a help file (type
  277. HELP CP DEF) that is almost 600 lines that goes into detail on each
  278. subcommand.
  279. Privilege Class:  B, G
  280. Function Type:  R, G
  281.  
  282. DETACH or DET : The DETACH command is used to remove a virtual device from the
  283. ~~~~~~~~~~~~~   virtual machine.  The subcommands are as follows:
  284.  
  285.   o  vaddr (vaddr...) : used for multiple addresses to be detached where vaddr
  286.                         is the virtual address (cuu) of the device to be
  287.                         detached.
  288.   o  vaddr-vaddr : used to detach a range of addresses.
  289.   o  CHANNEL c : detaches the real address of the channel.
  290. Privilege Class:  B, G
  291. Function Type:  R, G
  292.  
  293. DIAL : Using the DIAL command logically connects a switched line, leased line,
  294. ~~~~   locally attached, or remote Binary Synchronous (BSC) terminal to a
  295. previously logged-on multiple-access virtual machine.  It is in the format of
  296. DIAL userid (vaddr) where the userid is that to be connected to and the
  297. vaddr is the optional virtual address.
  298. Privilege Class:  ANY
  299. Function Type:  ANY
  300.  
  301. DISABLE : The DISABLE command prevents low speed communications lines from
  302. ~~~~~~~   accessing the system.
  303. Privilege Class:  A, B
  304. Function Type:  R
  305.  
  306. DISCONN or DISC : The DISCONNECT command is used to disconnect your terminal
  307. ~~~~~~~~~~~~~~~   from the system while the virtual machine continues
  308. operation.  Using the DISC HOLD or DISC HO option, you specify that the
  309. communications line is not to be disabled which allows you to avoid re-dialing
  310. the system.
  311. Privilege Class:  ANY
  312. Function Type:  ANY
  313.  
  314. DISPLAY or D : The DISPLAY command allows you to display virtual machine
  315. ~~~~~~~~~~~~   components at your terminal.  Depending on what variable
  316. follows the D or DISPLAY command from CP, you can display virtual storage
  317. locations, storage keys, general registers, floating-point registers, control
  318. registers, vector registers, VAC (Vector Activity Counter), VSR (Vector Status
  319. Register), VMR (Vector Mask Register), PSW (Program Status Word), CAW (Channel
  320. Address Word), and CSW (Channel Status Word).
  321. Privilege Class:  G
  322. Function Type:  G
  323.  
  324. DMCP : This command prints the contents of real storage locations on a user's
  325. ~~~~   virtual spooled printer.
  326. Privilege Class:  C, E
  327. Function Type:  P
  328.  
  329. DRAIN : The DRAIN command stops spooling operations on a specified real unit's
  330. ~~~~~   read devices after the file currently being processed has been
  331. completed.
  332. Privilege Class:  D
  333. Function Type:  S
  334.  
  335. DUMP or DU : Use the DUMP command to print the contents of various components
  336. ~~~~~~~~~~   of the virtual machine on the virtual spooled printer.  Depending
  337. on what variable is placed after the DUMP or DU command, the items printed
  338. include virtual PSW (Program Status Word), general registers, floating-point
  339. registers, control registers, storage keys, and virtual storage locations.
  340. Privilege Class:  G
  341. Function Type:  G
  342.  
  343. ECHO or EC : Defaulted at 1, the ECHO command places the terminal in the echo
  344. ~~~~~~~~~~   environment in which any line entered is transmitted unchanged
  345. back to the terminal a specified number of times, depending on the variable
  346. entered immediately after the word ECHO or EC.
  347. Privilege Type:  G
  348. Function Type:  G
  349.  
  350. ENABLE : Use the ENABLE command to enable the previously disabled or nonabled
  351. ~~~~~~   devices so users may access the system.
  352. Privilege Class:  A, B
  353. Function Type:  R
  354.  
  355. EXTERNAL or EXT : The EXTERNAL command allows the user to simulate an external
  356. ~~~~~~~~~~~~~~~   interrupt to the virtual machine and to return control to
  357. that machine.  The hexadecimal code following the word EXTERNAL or EXT is
  358. associated with the external interrupt, the default being the number 40 which
  359. is associated with the external interrupt button on a system console.
  360. Privilege Class:  G
  361. Function Type:  G
  362.  
  363. FLUSH : The FLUSH command halts and immediately purges on hold the current
  364. ~~~~~   output on a specified unit record device.
  365. Privilege Class:  D
  366. Function Type:  S
  367.  
  368. FORCE : This command forces a logoff of any user of the system.
  369. ~~~~~
  370. Privilege Class:  A
  371. Function Type:  O
  372.  
  373. FREE : Use the FREE command to remove a set of spool files belonging to a
  374. ~~~~   specified user from a system hold status.
  375. Privilege Class:  D
  376. Function Type:  S
  377.  
  378. HALT : The HALT command terminates any active channel program on a specified
  379. ~~~~   real device.
  380. Privilege Class:  A
  381. Function Type:  O
  382.  
  383. HOLD : The HOLD command places user spool files in a system hold status.
  384. ~~~~
  385. Privilege Class:  D
  386. Function Type:  S
  387.  
  388. INDICATE or IND : At your terminal, you can display the use of and contention
  389. ~~~~~~~~~~~~~~~   for major system resources with the INDICATE command.  The
  390. following variables that follow the word INDICATE or IND show the following
  391. data:
  392.  
  393.   o  LOAD : shows number of users in queue 1 and queue 2, the usage of real
  394.             storage, and the ratio of active users to users being serviced.
  395.             This is done by returning values that indicate operating load on
  396.             the system.
  397.   o  USER : displays the amounts of system resources used by your virtual
  398.             machine in the current terminal session.
  399. Privilege Class:  A, E, G
  400. Function Type:  O, A, G
  401.  
  402. IPL or I : Generally used to return to CMS via the IPL CMS  or I CMS command,
  403. ~~~~~~~~   the IPL command simulates an initial program load function for a
  404. virtual machine.  Subcommands are as follows:
  405.  
  406.   o  vaddr : virtual address (cuu) of the device that contains the nucleus to
  407.              be loaded.
  408.   o  cylno : cylinder containing the IPL data which defaults to 0.
  409.   o  nnnnn : block address containing the IPL data which defaults to 0.
  410.   o  CLEAR : sets virtual storage space to binary zeros before the operating
  411.              system is loaded.
  412.   o  NOCLEAR : allows contents of your virtual storage space to remain
  413.                unchanged prior to program load.
  414.   o  STOP : halts the virtual machine during the IPL procedure just before the
  415.             initial PSW is loaded.
  416.   o  ATTN : generates an attention interrupt to the virtual machine during the
  417.             IPL procedure.
  418.   o  PARM p1 (p2...) : processes up to 64 bytes of data to your virtual
  419.                        machine's general registers starting with the high
  420.                        order byte of general register 0.
  421.   o  systemname : simulates IPL function when loading a named system that was
  422.                   previously saved.
  423. Privilege Class:  G
  424. Function Type:  G
  425.  
  426. LINK : The LINK command is used to make a device that is associated with
  427. ~~~~   another virtual machine available at your virtual machine configuration
  428. based upon info in that user's directory entry.  This command is in the format
  429. of LINK TO userid vaddr1 AS vaddr2 (mode) ((PASS=) password(1)).
  430. Privilege Class:  G
  431. Function Type:  G
  432.  
  433. LOADBUF : On a 1403 printer, the LOADBUF command loads the Universal Character
  434. ~~~~~~~   Set (UCS) with a specified print train or chain image.  On a
  435. 3203, 3211, 3212, 4245, or 4248 printer, it loads the UCS or the Forms Control
  436. Buffer (FCB) with a specified image.  On a 3289 Model 4 printer, it loads the
  437. Font Offset Buffer (FOB) with the image print belt and the FCB.
  438. Privilege Class:  D
  439. Function Type:  S
  440.  
  441. LOADVFCB : This command specifies the forms control buffer image for different
  442. ~~~~~~~~   virtual spooled printers.  The variables that follow it include:
  443.  
  444.   o  vaddr
  445.   o  FCB : required reserved keyword meaning Forms Control Buffer.
  446.   o  name : a name that is system defined.
  447.   o  INDEX (nn) : place initial printing position in number nn for the 3211
  448.                   printer.
  449. Privilege Class:  G
  450. Function Type:  G
  451.  
  452. LOCATE : Use the LOCATE command to find the addresses of CP control blocks
  453. ~~~~~~   associated with a particular user, a user's device, or a real system
  454. device.
  455. Privilege Class:  C, E
  456. Function Type:  P
  457.  
  458. LOCK : This command permanently locks in selected pages of real storage.
  459. ~~~~
  460. Privilege Class:  A
  461. Function Type:  O
  462.  
  463. LOGOFF or LOGOUT or LOG : Used to terminate a virtual machine session and
  464. ~~~~~~~~~~~~~~~~~~~~~~~   disconnect your virtual machine from the system,
  465. this command can be used with the HOLD option (i.e.  LOG HOLD) for retaining
  466. the connection allowing for a switched communications line to enable one to
  467. log on without re-dialing the system.
  468. Privilege Class:  ANY
  469. Function Type:  ANY
  470.  
  471. LOGON or LOGIN or L : Obvious enough, the LOGIN or LOGON command is used to
  472. ~~~~~~~~~~~~~~~~~~~   identify yourself to the system and to access that
  473. system.  Following the words LOGIN or LOGON or L, type your userid which is
  474. the identifier assigned to you in the system.  If the system you are logging
  475. onto does NOT have password suppression, your password can follow directly
  476. after your userid.  NOTE:  If the system you are on does have password
  477. suppression (i.e.  it does not echo to your screen what you type when you type
  478. your password), you will get a system error message if you try to put it on
  479. the same line as your userid.  The NOIPL option, which would follow your
  480. password and userid, specifies that the IPL device or name in the directory
  481. should not be used for an automatic IPL.
  482. Privilege Class:  ANY
  483. Function Type:  ANY
  484.  
  485. MESSAGE or MSG or M : Use the MESSAGE command to transmit message text to a
  486. ~~~~~~~~~~~~~~~~~~~   specified userid or to the primary system operator
  487. userid.  MSG userid msgtext sends msgtext to the userid specified after
  488. userid. If userid is replaced with *, the text is sent to yourself.  Also, if
  489. the userid is replaced with OPERATOR, the message text is sent to the primary
  490. system operator regardless of his userid.
  491. Privilege Class:  A, B, ANY
  492. Function Type:  O, ANY
  493.  
  494. MIGRATE : The MIGRATE command activates the normal page/swap table migration
  495. ~~~~~~~   routines or forces a particular user's pages to a secondary device
  496. even if that user is currently active.
  497. Privilege Class:  A
  498. Function Type:  O
  499.  
  500. MONITOR : To initiate or override the system-generated function or to
  501. ~~~~~~~   terminate the recording of events occurring in the real machine, use
  502. the MONITOR command.
  503. Privilege Class:  A, E
  504. Function Type:  O
  505.  
  506. MSGNOH : The MSGNOH command allows a service virtual machine to send messages
  507. ~~~~~~   to specified users without the standard header associated with the
  508. MESSAGE command.
  509. Privilege Class:  B
  510. Function Type:  R
  511.  
  512. NETWORK : The NETWORK command allows you to load, dump and control operation
  513. ~~~~~~~   of a 3704 or 3705 and to control operation of a 3725 control program
  514. operating in 270x emulation mode (EP).  Also, it allows control of remote 3270
  515. devices via binary synchronous lines.
  516. Privilege Class:  A
  517. Function Type:  O
  518.  
  519. NOTREADY or NOTR : Using the NOTREADY command causes the virtual device, which
  520. ~~~~~~~~~~~~~~~~   is specified after the NOTREADY statement via cuu address,
  521. to appear as if it had changed from ready to not ready status.
  522. Privilege Class:  G
  523. Function Type:  G
  524.  
  525. ORDER or ORD : ORDER is used to place your closed spool files in a specific
  526. ~~~~~~~~~~~~   order by device type.  These spool files include READER,
  527. PRINTER, and PUNCH files and can be sorted by CLASS, FORM, and spoolid.
  528. Privilege Class:  D, G
  529. Function Type:  S, G
  530.  
  531. PER : PER allows one to monitor certain events as they occur during program
  532. ~~~   execution in the user's virtual machine.  This command can monitor the
  533. fetching and execution of an instruction, the execution of a successful branch
  534. instruction, the instruction of an instruction that alters a specific general
  535. purpose register, and the execution of an instruction in the virtual machine
  536. that alters storage.
  537. Privilege Class:  A, B, C, D, E, F, G
  538. Function Type:  G
  539.  
  540. PURGE or PUR : Use the PURGE command to remove your own closed spool files
  541. ~~~~~~~~~~~~   from the system before they are printed or punched by the
  542. spooling devices, or before they are read by a user.  The spool file
  543. specifications include READER, PRINTER, and PUNCH files as well as the ALL
  544. option which purges all of the above mentioned files.
  545. Privilege Class:  D, G
  546. Function Type:  S, G
  547.  
  548. QUERY or Q : Also available in CMS mode, the QUERY command is used to
  549. ~~~~~~~~~~   determine your system status and machine configuration.
  550. Although there are far too many subcommands of the QUERY command, the
  551. following is a list of items that may be queried.  I recommend, for full
  552. detail, using the HELP CP QUERY command as it is quite thorough (over 1000
  553. lines) in explaining the QUERY command.
  554.  
  555.   o  The time you have used during a terminal session.
  556.   o  The number of closed input and output spool files associated with
  557.      your virtual machine.
  558.   o  The current settings of the color and/or extended highlight values
  559.      in effect for your virtual machine console.
  560.   o  The current settings of the SET command functions.
  561.   o  The current settings of the TERMINAL command functions.
  562.   o  The status of all the devices on your virtual machine.
  563.   o  The channel operating mode of your virtual machine, whether
  564.      block-multiplexer or selector.
  565.   o  A listing of all users who are linked to a given virtual address,
  566.      together with their device addresses and access modes.
  567.   o  Display of the secondary user (secuser) that is specified in the
  568.      CONSOLE directory statement.
  569.   o  Identification and attributes associated with your virtual
  570.      PRINTER, PUNCH, and READER spool files.
  571.   o  The identification of your virtual processor.
  572.   o  The mode of processor operation of your VM/SP HPO installation:
  573.      uniprocessor mode (UP), attached processor mode (AP), or
  574.      multiprocessor mode (MP).
  575.   o  The userid and system identifier.
  576.   o  A listing of the PER traceset elements.
  577.   o  The log messages of the day.
  578.   o  The names of the users that are logged on.
  579.   o  The number of users that are logged on or dialed to the system.
  580.  
  581. NOTE:  There are other operands you can use with the QUERY command if you
  582.        have the privilege class required to use them.
  583. Privilege Class:  A, B, C, D, E, F, G
  584. Function Type:  O, R, P, S, A, C, G
  585.  
  586. QVM : Use this command to request the transition from the VM/SP environment to
  587. ~~~   native mode for a particular virtual machine.
  588. Privilege Class:  A
  589. Function Type:  O
  590.  
  591. READY : In the format of READY vaddr, this command is used to set a device-end
  592. ~~~~~   interruption pending for the specified virtual device.
  593. Privilege Class:  G
  594. Function Type:  G
  595.  
  596. REPEAT : Use the REPEAT command to increase the number of copies of an output
  597. ~~~~~~   file or to place the current output file in a hold status increasing
  598. or not increasing the number of copies to be created.
  599. Privilege Class:  D
  600. Function Type:  S
  601.  
  602. REQUEST or REQ : Simply use the REQUEST command to make an attention interrupt
  603. ~~~~~~~~~~~~~~   at your virtual console.
  604. Privilege Class:  G
  605. Function Type:  G
  606.  
  607. RESET : Also in the format of RESET vaddr, this command is used to clear all
  608. ~~~~~   pending interrupts from the specified virtual device.
  609. Privilege Class:  G
  610. Function Type:  G
  611.  
  612. REWIND or REW : The REWIND command is used to rewind a real tape unit attached
  613. ~~~~~~~~~~~~~   to your virtual machine at a specified virtual device address
  614. in the format REWIND vaddr.
  615. Privilege Class:  G
  616. Function Type:  G
  617.  
  618. SAVESYS : This command allows you to save a virtual machine storage space with
  619. ~~~~~~~   registers and the PSW as they currently exist.  It is used in the
  620. process of creating named systems.
  621. Privilege Class:  E
  622. Function Type:  A
  623.  
  624. SCREEN or SCRE : Use the SCREEN command to alter or change any extended color
  625. ~~~~~~~~~~~~~~   and/or extended highlight definitions for your virtual
  626. machine console.  You may issue the command from any IBM supported terminal or
  627. from a PROFILE EXEC because the SCREEN command is not device dependent.
  628. However, the SCREEN command is only valid when the Extended Color Feature has
  629. been applied to the terminal controller.
  630.  
  631. You can assign extended color and extended highlighting values to six distinct
  632. display screen areas:  the input area, the system status area, and the output
  633. area that encompasses three other areas: CP output, virtual machine output,
  634. virtual machine output, and an input redisplay area.  The physical attributes
  635. of 3270 Information Display station screens vary according to model.
  636.  
  637. Because this command mainly applies to people who are not on dial-up, I have
  638. elected not to detail all of the variables available with the SCREEN command.
  639. Once again, I recommend you using HELP CP SCREEN for details.
  640. Privilege Class:  G
  641. Function Type:  G
  642.  
  643. SEND : Using the Single Console Image Facility, the SEND command is used to
  644. ~~~~   pass commands and message replies for the secondary user's console to
  645. disconnect virtual machines for execution.  This command is executed in the
  646. format:  SEND (CP) userid (text).
  647. Privilege Class:  G
  648. Function Type:  G
  649.  
  650. SET : Use the SET command to control various functions within your virtual
  651. ~~~   system.  This command has a large number of variables that can be SET
  652. and details for each of the variables can be obtained from the HELP CP SET
  653. file.
  654. Privilege Class:  A, B, E, F, G
  655. Function Type:  O, R, A, C, G
  656.  
  657. SHUTDOWN : This command, of course, systematically ends all virtual machine
  658. ~~~~~~~~   functions and checkpoints the system for an eventual warn start.
  659. Privilege Class:  A
  660. Function Type:  O
  661.  
  662. SLEEP or SL : To place the virtual machine in a dormant state but allow
  663. ~~~~~~~~~~~   messages to be displayed, use the SLEEP command in the format
  664. of SLEEP nn (time-specification) where time-specification is SEC for seconds,
  665. MIN for minutes, or HR for hours and nn is the number of the amount of time
  666. for the machine to be in dormant state.
  667. Privilege Class:  G
  668. Function Type:  G
  669.  
  670. SMSG or SM : The SMSG command is used to send a special message to a virtual
  671. ~~~~~~~~~~   machine programmed to accept and process the message.  The format
  672. of this command is SMSG userid msgtext where userid is the userid to receive
  673. the message and msgtext is the message to be sent to the userid.
  674. Privilege Class:  G
  675. Function Type:  G
  676.  
  677. SPACE : Use the SPACE command to force the output on a specified printer to be
  678. ~~~~~   single spaced for the current active spool file regardless of the
  679. carriage control commands in the actual file.
  680. Privilege Class:  D
  681. Function Type:  S
  682.  
  683. SPMODE : SPMODE allows the system operator to establish or reset the single
  684. ~~~~~~   processor mode environment.
  685. Privilege Class:  A
  686. Function Type:  O
  687.  
  688. SPOOL or SP : Use the SPOOL command to modify the spooling control options in
  689. ~~~~~~~~~~~   effect for a given virtual spooling device or for a group of
  690. devices.  The SPOOL command can also start or stop the spooling of virtual
  691. console input and output.  You can direct a file to a remote location by using
  692. the SPOOL command in conjunction with the TAG command.
  693. Privilege Class:  G
  694. Function Type:  G
  695.  
  696. SPTAPE : Use this command to dump spool files to tape or to load spool files
  697. ~~~~~~   from tape.
  698. Privilege Class:  D
  699. Function Type:  S
  700.  
  701. START : The START command restarts a spooling device after it has been drained
  702. ~~~~~   or changes the output class that it may service.
  703. Privilege Class:  D
  704. Function Type:  S
  705.  
  706. STCP : To alter the contents of real storage but not real PSW or real
  707. ~~~~   registers, use the STCP command.
  708. Privilege Class:  C
  709. Function Type:  P
  710.  
  711. STORE or ST : The STORE command is used to alter the contents of specified
  712. ~~~~~~~~~~~   registers and locations of the virtual machine.  As well as
  713. saving virtual machine data in low storage, the contents of the following can
  714. be altered:
  715.  
  716.   o  Virtual storage locations
  717.   o  General registers
  718.   o  Floating-point registers
  719.   o  Control registers
  720.   o  Program Status Word (PSW)
  721. Privilege Class:  G
  722. Function Type:  G
  723.  
  724. SYSTEM or SYS : SYSTEM is used to simulate the action of the RESET and RESTART
  725. ~~~~~~~~~~~~~   buttons on the real computer console, and to clear storage.
  726. The variables are as follows:
  727.  
  728.   o  CLEAR : clears virtual storage and virtual storage keys to binary zeros.
  729.   o  RESET : clears all pending interrupts and conditions in the virtual
  730.              machine.
  731.   o  RESTART : simulates the hardware system RESTART function by storing the
  732.                current PSW at virtual location eight and loading, as the new
  733.                PSW, the doubleword from virtual location zero.
  734. Privilege Class:  G
  735. Function Type:  G
  736.  
  737. TAG or TA : The TAG has many different variables that can be tagged, which are
  738. ~~~~~~~~~   too many to list here because of different settings for each one,
  739. but it is used to associate file descriptive information with a spool file.
  740. Privilege Class:  G
  741. Function Type:  G
  742.  
  743. TERMINAL or TERM : The TERMINAL command is used to control the following
  744. ~~~~~~~~~~~~~~~~   functions associated with your virtual console:
  745.  
  746.   o  Logical line-editing symbols
  747.   o  Masking of password
  748.   o  The APL character set
  749.   o  The Text character set
  750.   o  Signaling of an attention interrupt
  751.   o  Attention handling mode for your virtual console
  752.   o  Line length for output on your virtual console
  753.   o  Specifying terminal device type as 3101 or TTY
  754.   o  Location of cursor preceding terminal read
  755.   o  Scrolling rate for 3101 terminal
  756. Privilege Class:  G
  757. Function Type:  G
  758.  
  759. TRACE or TR : Use the TRACE command to trace specified virtual machine
  760. ~~~~~~~~~~~   activity and to record the results at the terminal, on a virtual
  761. spooled printer, or on both terminal and printer.  If you issue more than one
  762. TRACE command, the operands are cumulative; that is, operands specified for the
  763. first time are activated, whereas those specified with new modifiers are
  764. updated.  The RUN and NORUN operands, however, can be specified in different
  765. tracing functions and do not cause a conflict.
  766.  
  767. You cannot issue the TRACE command while preferred machine assist is
  768. operating, whether or not you have enabled the preferred machine assist
  769. feature's control switch assist.
  770. Privilege Class:  G
  771. Function Type:  G
  772.  
  773. TRANSFER or TRAN : This command is used to transfer your closed spool files to
  774. ~~~~~~~~~~~~~~~~   a specified user or queue, or to reclaim closed spool files
  775. that you created.
  776. Privilege Class:  D, G
  777. Function Type:  S, G
  778.  
  779. UNLOCK : Use the UNLOCK command to unlock page frames previously locked by a
  780. ~~~~~~   LOCK command.
  781. Privilege Class:  A
  782. Function Type:  O
  783.  
  784. VARY : The VARY command marks a device available or unavailable for use by a
  785. ~~~~   user or the control program.
  786. Privilege Class:  B
  787. Function Type:  R
  788.  
  789. VMDUMP or VMD : The VMDUMP command dumps virtual storage that VM/SP HPO
  790. ~~~~~~~~~~~~~   creates for the virtual machine user.  VMDUMP dumps the
  791. following:
  792.  
  793.   o  Virtual Program Status Word (PSW)
  794.   o  General registers
  795.   o  Floating-point registers
  796.   o  Control registers
  797.   o  Storage protection keys
  798.   o  Virtual machine type identification
  799.   o  Timer values
  800. Privilege Class:  G
  801. Function Type:  G
  802.  
  803. WARNING : Use the WARNING command to transmit high-priority messages to a
  804. ~~~~~~~   specified user or to all users.
  805. Privilege Class:  A, B
  806. Function Type:  O
  807.  
  808. ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  809. This article is far from totally complete as far as in-depthness goes.  As I
  810. have stated in numerous portions of this file, the VM/CMS system has a very
  811. good HELP file system, and from CMS, the command HELP CP <command> will, in
  812. most cases, allow you to read a relatively clear text file containing the
  813. details and usage specifications of these commands.  I hope that, should you be
  814. moving around a VM/CMS system, this file will assist you in the CP mode.
  815.  
  816. For those that wish to contact me for commentary on this file topic or other
  817. topic conversation, you can send e-mail to my network addresses:
  818.  
  819.                     Internet:  C488869@UMCVMB.MISSOURI.EDU
  820.                       Bitnet:  C488869@UMCVMB.BITNET
  821.  
  822. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  823.