HP 3000 Manuals

Parameters within Syntax (cont..) [ Using Your System The User's Guide ] MPE/iX 5.0 Documentation


Using Your System The User's Guide

Parameters within Syntax (cont..) 

Positional parameters (cont.) 

LISTFILE 

The LISTFILE command displays descriptions about one or more disk files
at a specified level of detail.  This command is a functional superset of
the LISTF and LISTFTEMP commands.

Syntax 

LISTFILE [{fileset             }] [[;FORMAT=] format_opt] [;PASS]
         [{(fileset [,fileset])}]
Parameters 

fileset               Specifies the set of files to be listed.  The form
                      of this positional parameter is as follows:

                           filename[.groupname[.accountname] ]

                      You can use wildcard characters to specify certain
                      types of characters as follows:

                         *   # specifies a single numeric character.

                         *   ?  specifies a single alphanumeric
                             character.

                         *   @ specifies zero or more alphanumeric
                             characters.

                      Each wildcard character is counted toward the
                      eight-character limit for group, account, and file
                      names.

                      This parameter also supports character class
                      matches.  For instance, [A-DQR]@ would search for
                      all files starting with ABCDQR.

FORMAT                Specifies a format option.  This parameter does not
                      affect the files selected for display.  You can
                      select from the options shown in the following
                      table for the format_opt value.

          Format Selection 

-----------------------------------------------------------------------------------------------
|          |                       |                                                          |
|  Option  |         Name          |                  Displayed Information                   |
|          |                       |                                                          |
-----------------------------------------------------------------------------------------------
|          |                       |                                                          |
|    -3    | [REV BEG]Detail[REV   | Shows the hexadecimal listing of the file label, the     |
|          | END]                  | lockword of the creator, and the label address.  You     |
|          |                       | must have account manager (AM) or system manager (SM)    |
|          |                       | capability to use this option.                           |
|          |                       |                                                          |
-----------------------------------------------------------------------------------------------
|          |                       |                                                          |
|    0     | Files                 | Shows only the file name.  This is the default.          |
|          |                       |                                                          |
-----------------------------------------------------------------------------------------------
|          |                       |                                                          |
|    1     | Summary               | Shows the file name, file code, record size, record      |
|          |                       | format, ASCII or binary records, carriage control        |
|          |                       | option, current end-of-file location, and the maximum    |
|          |                       | number of records allowed in the file.                   |
|          |                       |                                                          |
-----------------------------------------------------------------------------------------------
|          |                       |                                                          |
|    4     | Security              | Shows the security matrix for the file.  This includes   |
|          |                       | account-level, group-level, and file-level security, and |
|          |                       | the access permissions for the user.                     |
|          |                       |                                                          |
-----------------------------------------------------------------------------------------------
|          |                       |                                                          |
|    6     | Qualify               | Shows only the fully qualified file name.                |
|          |                       |                                                          |
-----------------------------------------------------------------------------------------------

PASS                  Displays security-sensitive data.  See "Permissions
                      and Restrictions" for more information.

Operation Notes 

   *   Usage 

       You can enter this command from a session, a job, a program, or in
       break mode.  Pressing Break aborts the execution of this command.

   *   Permissions and Restrictions 

       As a standard user, you can display any level of information on
       files that you create, but you cannot use the PASS option for
       files that you do not own.  If you have account manager (AM)
       capability, you can use the PASS option for any file within the
       account.  If you have system manager (SM) capability, you can use
       the PASS option for any file on the system.

Example 

   *   To display the fully qualified file name for FILE1, enter:

            :LISTFILE FILE1,6 
            FILE1.PUB.PRACTICE

Related Commands 

     LISTF
     LISTFTEMP

LISTGROUP 

The LISTGROUP command displays information about one or more groups. 

Syntax 

LISTGROUP [groupset][,listfile][;PASS]

Parameters 

groupset              Specifies the set of groups to be listed.  If you
                      have account manager (AM) or system manager (SM)
                      capability, the default is all (@) groups within
                      your logon account.  If you do not have either
                      capability, the default is your logon group.

                      You can use wildcard characters to specify certain
                      types of characters as follows:

                         *   # specifies a single numeric character.

                         *   ?  specifies a single alphanumeric
                             character.

                         *   @ specifies zero or more alphanumeric
                             characters.

                      Each wildcard character is counted toward the
                      eight-character limit for group, account, and file
                      names.

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

PASS                  Permits those with account manager (AM) and system
                      manager (SM) capability to see the group password.

Operation Notes 

   *   Usage 

       You can enter this command from a session, a job, a program, or in
       break mode.  Pressing Break aborts the execution of this command.

   *   Restrictions 

       If you have system manager (SM) capability, you can display any
       group on the system.  If you have account manager (AM) capability,
       you can display any group in your account.  If you have neither
       capability, you can only display your logon group.

Example 

   *   To display information, including the password, for a group named
       DEVELOP, enter:

            :LISTGROUP DEVELOP;PASS 

       The system responds by printing the following information on your
       screen:
___________________________________________________________________
|                                                                 |
|     *******************                                         |
|     GROUP: DEVELOP.HPXLII                                       |
|                                                                 |
|     DISC SPACE: 5752(SECTORS)            PASSWORD: GROUPASS     |
|     CPU TIME  : 0(SECONDS)               SECURITY--READ    : GU |
|     CONNECT TIME: 0(MINUTES)                       WRITE   : GU |
|     DISC LIMIT: UNLIMITED                          APPEND  : GU |
|     CPU LIMIT : UNLIMITED                          LOCK    : GU |
|     CONNECT LIMIT: UNLIMITED                       EXECUTE : GU |
|     PRIV VOL : n/a                                 SAVE    : GU |
|     FILE UFID: $000D4001 $80001050 $000FF620 $00000008 $0000000A|
|     MOUNT REF CNT:  n/a                                         |
|     HOME VOL SET :  MPE_SYS_VOL_SET                             |
|     CAP: IA,BA                                                  |
___________________________________________________________________

            

Related Commands 

     ALTGROUP
     LISTACCT
     LISTUSER
     NEWGROUP

LISTSPF 

The LISTSPF command produces a listing of input and output spooled files.
The information reflects the status at the time you enter the command and
always appears on the standard list device.

Syntax 

LISTSPF [[IDNAME=] {spoolid                }] [;DETAIL]
        [          {(spoolid [,spoolid]...)}] [;STATUS]
Parameter Definitions 

IDNAME                Specifies one or more spool file IDs.  #Innn 
                      represents input spool files and #Onnn represents
                      output spool files.  The spooling subsystem assigns
                      these IDs when the spool files are created.

                      Rules for use of this parameter are as follows:

                         *   Use # optionally, but if you use it, make
                             sure to include an I or O with the # symbol.
                             #O is assumed if you do not specify either
                             #I or #O.

                         *   Use @ to specify all spool files.

                         *   Use I@ to specify all input spool files.
                             All input spool files reside in
                             @.IN.HPSPOOL.

                         *   Use O@ to specify all output spool files.
                             All output spool files reside in
                             @.OUT.HPSPOOL.

                         *   You must have account manager (AM)
                             capability when specifying O@ in order to
                             display all output spool files created by
                             users in the same account.  Similar rules
                             apply to I@ and @.

                         *   You must have system manager (SM) or system
                             supervisor (OP) capability when specifying
                             O@ in order to display all output spool
                             files on the system.  Similar rules apply to
                             I@ and @.

                         *   All users without AM, SM, or OP capability
                             are limited to displaying only files that
                             they have created.

                      The default display is all of the output spool
                      files created by the current user.account.  The
                      default display for the console user is all of the
                      output spool files on the system.

DETAIL                Produces a two-line description of the specified
                      spool file(s), rather than the default one-line
                      description.  You cannot specify the STATUS
                      parameter with this parameter.

STATUS                By default, LISTSPF displays a listing of selected
                      spool files, followed by a statistical summary of
                      these spool files, known as the status summary.  If
                      you specify the STATUS parameter, the system only
                      displays the status summary.  You cannot specify
                      the DETAIL parameter with this parameter.

Operation Notes 

   *   Usage 

       You can enter this command from a session, a job, a program, or in
       break mode.  Pressing Break aborts the execution of this command.

   *   First line fields and description 

       The first line of the display for LISTSPF appears as shown in the
       following example:
____________________________________________________________________________________
|                                                                                  |
|     SPOOLID  JOBNUM  FILEDES  PRI  COPIES  DEV    STATE   RSPFN   OWNER          |
|                                                                                  |
|     #01      J12345  $STDLIST   6       1  EPOC   CREATE  RSPFN   THISUSER.ACCOUN|
____________________________________________________________________________________

            

       Descriptions of the fields are as follows:

       SPOOLID               Indicates the unique spool file identifier.
                             You can display this output spool file by
                             entering PRINT 01.OUT.HPSPOOL.

       JOBNUM                Indicates the job or session identifier of
                             the job or session that created the spool
                             file.

       FILEDES               Indicates the formal or actual file
                             designator for the spool file.  The name of
                             a file equation becomes its formal file
                             designator.  For instance, printing
                             to a file equation, such as FILE
                             EPOCLONG;DEV=EPOC;ENV=LP88LONG.HPENV.SYS,
                             creates spool files whose formal designator
                             is EPOCLONG.

       PRI                   Indicates the input or output priority of
                             the spool file.

       COPIES                Indicates the total number of copies of the
                             spool file to be printed.

       DEV                   Indicates the spool file's destination as an
                             LDEV, device name, or device class name.
                             LDEVs intentionally appear with leading
                             zeroes to simulate a device name.

       STATE                 Indicates the current state of the spool
                             file as described below:

                                *   CREATE: An output spool file is being
                                    created; an output spooled device has
                                    been opened and is being written to,
                                    which generates an output spool file.
                                    When the device closes, the spool
                                    file enters the ready state.

                                *   READY: An output spool file is ready
                                    to be printed or an input spool file
                                    is ready to be accessed.

                                *   ACTIVE: An input spool file is being
                                    read from a stream file or a spooled
                                    device to a disk.

                                *   OPEN: A JOB input spool file (the
                                    $STDIN for a batch job) is being
                                    accessed by the job's CI process, or
                                    a data input spool file is being
                                    accessed by a process.

                                *   PRINT: An output spool file is
                                    printing.

                                *   DEFER: An output spool file is in a
                                    deferred state.

                                *   SPSAVE: Either you specified the
                                    SPSAVE option when you created the
                                    spool file or when the spool file
                                    would have been deleted after its
                                    final copy printed.  The final copy
                                    has printed, so the spool file is now
                                    in this state instead of being
                                    deleted.

                                *   PROBLM: The target device of the
                                    spool file does not match any device
                                    name or device class on the system.
                                    This usually occurs because you have
                                    restored the spool file to a system
                                    that has a different configuration
                                    from the system where you stored the
                                    spool file.

                                *   DELPND: Either the spooler has
                                    printed the last copy of the output
                                    spool file and is waiting for you or
                                    others to close the spool file before
                                    purging it, or you or others have
                                    requested that the spool file be
                                    purged and the deletion is pending on
                                    file management processing to finish.

                                *   XFER: The spool file has been
                                    selected for transport from one
                                    network another.

       RSPFN                 The columns under these letters are defined
                             as follows:

                                *   R indicates a restartable spooled job
                                    file.

                                *   S indicates that you have specified
                                    SPSAVE for this spool file.  The
                                    spool file is saved in the
                                    OUT.HPSPOOL group and account after
                                    the last copy prints.

                                *   P indicates that the spool file is
                                    private.

                                *   F indicates that the spool file has a
                                    forms message associated with it and
                                    requires special forms on which to
                                    print.  If a formid is present, you
                                    can show its identity by specifying
                                    the DETAIL parameter and looking on
                                    the second line of the display for
                                    the given spool file.

                                *   N indicates that the spool file is
                                    incomplete because sufficient
                                    account-level, group-level, or system
                                    disk space was unavailable when you
                                    created the spool file, or the system
                                    aborted while you were creating the
                                    spool file.

       OWNER                 Indicates the fully qualified name of the
                             creator of the spool file.

   *   Second line fields and description 

       The optional second line of the display for LISTSPF;DETAIL appears
       as shown in the following example:
_______________________________________________________________________________
|                                                                             |
|     FORMID   JOBNAME      COPSRM   SECTS   RECS   PAGES    DATE         TIME|
|                                                                             |
|              TESTJOB           1   250      500    ~9      12/20/88    8:39 |
|                                                                             |
_______________________________________________________________________________

            

       Descriptions of the fields are as follows:

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

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

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

       SECTS                 Indicates the number of sectors that the
                             spool file occupies.

       RECS                  Indicates the number of records in the spool
                             file.

       PAGES                 Indicates the number of physical pages in
                             the spool file.

       DATE                  Indicates the date that the file first
                             entered the ready state in month/day/year
                             form (mm/dd/yy).

       TIME                  Indicates the time that the file first
                             entered the ready state in 24-hour form
                             (hh:mm).

   *   Status display fields and description 

       The status display appears as shown in the following example:
_____________________________________________________________________
|                                                                   |
|     INPUT SPOOL FILES           OUTPUT SPOOL FILES                |
|     ACTIVE   = 1;               CREATE    = 2;       READY    = 3;|
|     OPEN     = 2;               DEFER     = 1;       SELECTED = 4;|
|     READY    = 3;               DELPND    = 0;       SPSAVE   = 1;|
|                                 PRINT     = 1;       XFER     = 0;|
|                                 PROBLM    = 0;                    |
|                                                                   |
|                                                                   |
|     TOTAL IN FILES  =  6;       TOTAL OUTFILES    = 8;            |
|           IN SECTORS = 144;           OUT SECTORS = 13090;        |
|                                                                   |
|     OUTFENCE  = 6                                                 |
|     OUTFENCE  = 10 FOR LDEV  6                                    |
_____________________________________________________________________

            

       Descriptions of the fields are as follows:

       ACTIVE              Indicates the number of input spool files
                           being read from a stream file or a spooled
                           device to a disk.

       OPEN                Indicates the number of JOB input spool files
                           (the $STDIN for a batch job) that are being
                           accessed by the job's CI process, or the
                           number of data input spool files that are
                           being accessed by a process.

       READY               Indicates the number of input spool files
                           ready to be accessed.

       CREATE              Indicates the number of output spool files
                           being created.

       DEFER               Indicates the number of output spool files in
                           a deferred state.

       DELPND              Indicates the number of output spool files
                           that the spooler is waiting for you or others
                           to close before it purges them.  This can also
                           indicate the number of spool files that you or
                           others have requested be purged, but deletion
                           is pending on file management processing to
                           finish.

       PRINT               Indicates the number of output spool files
                           that are printing.

       PROBLM              Indicates the number of spool files for which
                           the target device does not match any device
                           name or device class on the system.

       SELECTED            Indicates the number of output spool files
                           whose output priority is higher than the
                           global outfence.  This field shows the sum of
                           files printing plus the ready files whose
                           output priority is higher than the global
                           outfence.

       SPSAVE              Indicates the number of output spool files in
                           this state instead of being deleted after
                           printing.  This state occurs if you specified
                           the SPSAVE option of the SPOOLF command when
                           you created the spool file or when the spool
                           file would have been deleted after its final
                           copy printed.

       XFER                Indicates the number of output spool files
                           selected for transport from one network to
                           another.

       TOTAL IN FILES      Indicates the total number of input spool
                           files.

       IN SECTORS          Indicates the sector count for input spool
                           files.

       TOTAL OUTFILES      Indicates the total number of output spool
                           files.

       OUT SECTORS         Indicates the sector count for output spool
                           files.

       OUTFENCE            Indicates the global outfence and any
                           device-specific outfences.

Examples 

   *   To display all output spool files for the current user.account not
       using the console, enter:

            :LISTSPF 

       The system responds by producing the following display:
_____________________________________________________________________________
|                                                                           |
|     SPOOLID  JOBNUM  FILEDES  PRI COPIES DEV          STATE RSPFN  OWNER  |
|                                                                           |
|     #0123    J12     SP        13      2 PP           PRINT    F   DEV.HPE|
|     #0124    S14     LIST       9      1 00000012     READY    F   DEV.HPE|
|     #0128    J144    $STDLIST   8      1 EPOC         READY        DEV.HPE|
|     #01233   S1234   OUTLIST    0      1 FASTLP       DEFER        DEV.HPE|
|                                                                           |
|     INPUT SPOOL FILES       OUTPUT SPOOL FILES                            |
|     ACTIVE  = 0;            CREATE   = 0;        READY    = 2;            |
|     OPEN    = 0;            DEFER    = 1;        SELECTED = 3;            |
|     READY   = 0;            DELPND   = 0;        SPSAVE   = 0;            |
|                             PRINT    = 1;        XFER     = 0;            |
|                             PROBLM   = 0;                                 |
|                                                                           |
|     TOTAL IN FILES   = 0;   TOTAL OUTFILES    = 4;                        |
|           IN SECTORS = 0;         OUT SECTORS = 5964;                     |
|                                                                           |
|     OUTFENCE  = 6                                                         |
_____________________________________________________________________________

          Single-Line Display 

   *   To display all spool files for the current user.account not using
       the console, enter:

            :LISTSPF @;DETAIL 

       The system responds by producing the following display:
____________________________________________________________________________________
|                                                                                  |
|     SPOOLID JOBNUM   FILEDES PRI COPIES  DEV        STATE  RSPFN  OWNER          |
|             FORMID   JOBNAME     COPSRM  SECTS      RECS   PAGES  DATE     TIME  |
|                                                                                  |
|     #O123   J12      SP       13      2  PP         PRINT     F   DEV.HPE        |
|                      TESTJOB          1  250        500      125  07/09/88 8:39  |
|                                                                                  |
|     #O124   S14      LIST      9      1  00000012   READY     F   DEV.HPE        |
|             PAYCHECK TESTJOB          1  250        500       ~9  12/20/88 8:39  |
|                                                                                  |
|     #O128   J144     $STDLIST  8      5  EPOC       READY           DEV.HPE      |
|                      LPJOB            3  250        127       21 12/20/88 22:19  |
|                                                                                  |
|     #O1233  S1234    OUTLIST   0      1  FASTLP     DEFER DEV.HPE                |
|                      TESTJOB          1  250        500       ~9  12/20/88 8:39  |
|                                                                                  |
|     #I564   J164     $STDIN              00000010   READY          DEV.HPE       |
|                      BATCHJOB            17         12             2/20/88  22:23|
|                                                                                  |
|                                                                                  |
|     INPUT SPOOL FILES       OUTPUT SPOOL FILES                                   |
|     ACTIVE  = 0;            CREATE  = 0;                READY    = 2;            |
|     OPEN    = 0;            DEFER   = 1;                SELECTED = 3;            |
|     READY   = 1;            DELPND  = 0;                SPSAVE   = 0;            |
|                             PRINT   = 1;                XFER     = 0;            |
|                             PROBLM  = 0;                                         |
|                                                                                  |
|     TOTAL IN FILES   = 1;   TOTAL OUT FILES    = 4;                              |
|           IN SECTORS = 17;        OUT SECTORS  = 1000;                           |
|                                                                                  |
|     OUTFENCE  = 6                                                                |
|                                                                                  |
____________________________________________________________________________________

          Two-Line Display 

   *   To display abbreviated information for all output spool files of
       the current user.account not using the console, enter:

            :LISTSPF;STATUS 

       The system responds by producing the following status display:
____________________________________________________________
|                                                          |
|     INPUT SPOOL FILES       OUTPUT SPOOL FILES           |
|     ACTIVE  = 0;            CREATE  = 0;    READY    = 2;|
|     OPEN    = 0;            DEFER   = 1;    SELECTED = 3;|
|     READY   = 0;            DELPND  = 0;    SPSAVE   = 0;|
|                             PRINT   = 1;    XFER     = 0;|
|                             PROBLM  = 0;                 |
|                                                          |
|     TOTAL IN FILES   = 0;   TOTAL OUTFILES    = 4;       |
|           IN SECTORS = 0 ;        OUT SECTORS = 1000;    |
|                                                          |
|     OUTFENCE  = 6                                        |
|                                                          |
____________________________________________________________

          Status Display 

Related Commands 

     LISTFILE
     PRINT
     SPOOLF
     SHOWIN
     SHOWOUT

LISTUSER 

The LISTUSER command displays information about one or more users in an
ASCII format. 

Syntax 

LISTUSER [userset][,listfile][;PASS]

Parameters 

userset               Specifies the set of users to be listed.  If you
                      have account manager (AM) capability, the default
                      is all users in your account.  If you have system
                      manager (SM) capability, the default is all users
                      on the system.

                      You can use wildcard characters to specify certain
                      types of characters as follows:

                         *   # specifies a single numeric character.

                         *   ?  specifies a single alphanumeric
                             character.

                         *   @ specifies zero or more alphanumeric
                             characters.

                      Each wildcard character is counted toward the eight
                      character limit for group, account, and file names.

listfile              Specifies the name of the output file.  The default
                      is $STDLIST.

PASS                  Permits those with AM and SM capability to see the
                      user password.

Operation Notes 

   *   Usage 

       You can enter this command from a session, a job, a program, or in
       break mode.  Pressing Break aborts the execution of this command.

   *   Restrictions 

       If you have system manager (SM) capability, you can display any
       user on the system.  If you have account manager (AM) capability,
       you can display any user in your account.  If you have neither
       capability, you can only display your logon user.

Examples 

   *   To display information, including the password, for a user named
       PETE, enter:

            :LISTUSER PETE;PASS 

       The system responds by printing the following information on your
       screen:
_______________________________________________________________
|                                                             |
|     *******************                                     |
|     USER: PETE.HPXLII                                       |
|                                                             |
|     HOME GROUP: DEVELOP                  PASSWORD: MYPASS   |
|     MAX PRI   : 150                      LOC ATTR: $00000000|
|     LOGON CNT : 1                               WRITE   : GU|
|     CAP: AM,AL,GL,DI,CV,UV,LG,CS,ND,SF,IA,BA,PH,DS,MR,PM    |
_______________________________________________________________

            

   *   To display all users in an account named PRACTICE, enter:

            :LISTUSER @.PRACTICE 

Related Commands 

     ALTUSER
     LISTACCT
     LISTGROUP
     NEWUSER

NEWACCT 

The NEWACCT command enables a system administrator to create a new
account and assign one person as the manager of the account. 

Syntax 

NEWACCT acctname,mgrname [;PASS=[password]][;CAP=[capabilitylist]]

[;ACCESS=[(fileaccess)]]

Parameters 

acctname              Specifies the name to be assigned to the new
                      account.  This name must contain from one to eight
                      alphanumeric characters, beginning with an
                      alphabetic character.

mgrname               Specifies the name of the person to manage the
                      account.  This could be the same name as the system
                      administrator or another user.  To avoid assigning
                      the wrong capabilities to general users, the system
                      administrator should use this parameter for only
                      one account manager.  The system administrator
                      should use the NEWUSER command to assign additional
                      users to the account.

                      The default for this user is that no password is
                      assigned, and capabilitylist is the same as the
                      account capability.

                      The system administrator can later change the
                      attributes of an account manager by using the
                      ALTUSER command.

PASS                  Specifies the account password, only used for
                      verifying logon access.  This password must contain
                      from one to eight alphanumeric characters,
                      beginning with an alphabetic character.  The
                      default is that no password is assigned.

CAP                   Specifies the list of capabilities permitted for
                      this account.  Each capability is indicated by a
                      two-letter mnemonic, separated by commas, as
                      follows:

                           SM  =  System manager
                           AM  =  Account manager
                           AL  =  Account librarian
                           GL  =  Group librarian
                           DI  =  Diagnostician
                           OP  =  System supervisor
                           NA  =  Network administrator
                           NM  =  Node manager
                           SF  =  Save files
                           ND  =  Access to nonshareable I/O devices
                           UV  =  Use volumes
                           CV  =  Create volumes
                           CS  =  Use communication subsystem
                           PS  =  Programmatic sessions
                           LG  =  User logging
                           PH  =  Process handling
                           DS  =  Extra data segments
                           MR  =  Multiple RINS
                           PM  =  Privileged mode
                           IA  =  Interactive access
                           BA  =  Batch access

                      The defaults are AM, AL, GL, SF, ND, IA, and BA.

ACCESS                Specifies the restriction on file access pertinent
                      to this account.  Valid syntax options are as
                      follows:

                      {R}
                      {L}
                      {A} [,...]:  {ANY} [,...]
                      {W}          {AC }
                      {X}
                      where R, L, A, W, X specify modes of access by
                      types of users (ANY, AC, GU, AL, GL) and are
                      defined as follows:

                           R   =   Read
                           L   =   Lock (exclusive file access)
                           A   =   Append (implies L)
                           W   =   Write (implies A and L)
                           X   =   Execute

                      The user types are defined as follows:

                           ANY =   Any user
                           AC  =   Member of this account only

                      The default is no security restrictions at the
                      account level.  You can specify two or more user or
                      access types if you separate them with commas.

Operation Notes 

   *   Usage 

       You can enter this command from a session, a job, a program, or in
       break mode.  Pressing Break does not affect this command.

       You must have system manager (SM) capability in order to use this
       command.

   *   Creating the account structure 

       The system administrator creates accounts and designates someone
       to manage the accounts, called the account manager.  As an account
       manager, you can log on and redefine your own attributes and PUB
       groups.  You can can also define new users and groups.

       The capabilities and attributes that the account manager assigns
       to groups and users cannot exceed those assigned to the account
       itself by the system administrator.  For example, if the system
       administrator does not assign the account extra data segments (DS)
       capability, no users in the account have DS capability, which
       prohibits them from linking programs that use extra data segments.

   *   PUB group 

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

            R,X:ANY;A,W,L,S:AL,GU

   *   Parameter omissions 

       When you specify a parameter but omit its corresponding value (as
       in ACCESS= Return), the default value for the parameter is
       assigned (in this case, R,L,A,W,X:AC). The default is also
       assigned when you omit an entire parameter group (such as
       ACCESS=fileaccess).

Example 

   *   To create an account with the account name ACI, the account
       manager name MNGR, and read privileges for any user, enter:

            :NEWACCT ACI,MNGR;ACCESS=R:ANY 

Related Commands 

     ALTACCT
     ALTUSER
     LISTACCT
     NEWGROUP
     NEWUSER

NEWGROUP 

The NEWGROUP command creates a new group within an existing account. 

Syntax 

NEWGROUP groupname[.acctname] [;PASS=[password]]

[;CAP=[capabilitylist]][;ACCESS=[(fileaccess)]]

Parameters 

groupname             Specifies the name of the new group, which must
                      consist of from one to eight alphanumeric
                      characters, beginning with an alphabetic character.

acctname              Specifies the account in which the group is to
                      reside.  You must have system manager (SM)
                      capability to use this parameter.

PASS                  Specifies the group password, used for verifying
                      logon access only.  The default is that no password
                      is assigned.

CAP                   Lists capability class attributes consisting of any
                      or all of the following:

                           BA  =  Local batch access (default)
                           DS  =  Extra data segments
                           IA  =  Interactive access (default)
                           MR  =  Multiple RINS
                           PH  =  Process handling
                           PM  =  Privileged mode

                      This list imposes a limit on program files
                      belonging to the group.  You cannot assign a
                      capability to the group if it has not been defined
                      for the account in which the group resides.

ACCESS                Specifies the restriction on file access pertinent
                      to this group.  Valid syntax options are as
                      follows:

                      {R}          {ANY}
                      {L}          {AC }
                      {A} [,...]:  {GU } [,...]
                      {W}          {AL }
                      {X}          {GL }
                      where R, L, A, W, and X specify modes of access by
                      types of users (ANY, AC, GU, AL, and GL) and are
                      defined as follows:

                           R   =   Read
                           L   =   Lock (exclusive file access)
                           A   =   Append (implies L)
                           W   =   Write (implies A and L)
                           X   =   Execute
                           S   =   Save

                      The user types are defined as follows:

                           ANY =   Any user
                           AC  =   Member of this account only
                           GU  =   Member of this group only
                           AL  =   Account librarian user only
                           GL  =   Group librarian user only

                      You can specify two or more user or access types if
                      you separate them with commas.

                      The defaults for the public group (PUB) are:

                           R,X:ANY; A,W,L,S:AL,GU

                      The default for all other groups is:

                           R,A,W,L,X,S:GU

Operation Notes 

   *   Usage 

       You can enter this command from a session, a job, a program, or in
       break mode.  Pressing Break does not affect this command.

       You must have account manager (AM) or system manager (SM)
       capability in order to use this command.

   *   Creating the group structure 

       The system administrator creates accounts and designates someone,
       called the account manager, to manage the accounts.  As an account
       manager, you can use the NEWGROUP command to create groups within
       each account and to assign attributes.

       The attributes assigned to the group may not exceed those
       permitted for the accounts themselves (defined when the system
       administrator created the accounts); however, within account
       limits, you can redefine the group and user attributes and
       capabilities, as well as those of the PUB group.

   *   PUB group 

       The PUB group is initially assigned the same capability class
       attributes, permanent file space limit, CPU limit, and
       connect-time limit as the account, but without a password.  Its
       initial security allows read (R) and execute (X) access to all
       users (ANY) who successfully log on to the account, and append
       (A), write (W), lock (L), and save (S) access to the account
       librarian (AL) and group users (GU) only.

       These access provisions are as follows:

            R,X:ANY;A,W,L,S:AL,GU

   *   Parameter omissions 

       When you specify a parameter but omit its corresponding value (as
       in ACCESS= Return), the default value for the parameter is
       assigned (in this case, R,L,A,W,X:AC). The default is also
       assigned when you omit an entire parameter group (such as
       ACCESS=fileaccess).

Examples 

   *   To create a new group named GROUP1 with all default capabilities,
       enter:

            :NEWGROUP GROUP1 

   *   To create a new group named G2 in the account WISDOM and assign it
       process handling (PH) and multiple RINs (MR) capabilities while
       retaining the default capabilities, enter:

            :NEWGROUP G2.WISDOM;CAP=PH,MR,IA,BA 

Related Commands 

     ALTGROUP
     LISTGROUP
     NEWACCT
     NEWUSER



MPE/iX 5.0 Documentation