|
With a mouseclick you get a describtion of the screen item.
Position Screen in the Join List
+ | - Page up or down towards the beginning or end of the Join list. Sending an empty command field (i.e. pressing ENTER) has the same effect as executing the command '+': i.e. page one screen further toward the end of the list.
++ | -- Position the screen at the end/beginning of the Join list.
+n | -n Position the screen n lines further towards the end/beginning of the list.
Breakpoint / Execute BS2000 Command
/ Break: Switch to BS2000 command mode. Return to the JES program with the /R [esume] BS2000 command.
/cmd Execute the BS2000 command cmd .
% cmd Execute the AID command.
Commands for controlling CFS Connections
Commands for controlling and administering dialog sessions with CFS connections.
These commands can be issued from any JES screen.
n Open a new Connection under the number n, or resume an existing dialog session running under the Connection opened under number n.
OCn Open Connection. Open a new Connection with the number n (0 <= n <= 9)
CCn Continue in Connection. Continue the dialog session under the existing open Connection n.
DCn Disable Connection. A Connection should normally be terminated by issuing a /LOGOFF command from inside the Connection.
CD Connection Display. A summary of all open Connections will be displayed.
For a full description of the individual commands, see the CFS User Manual, Chapter 9 "Connections".
A [opt] JES begins executing the defined X Actions (Variable Action ONX...). In conjunction with issuing a command A, an optional mnemonic can be appended which will control the Termination Acknowledgement. If opt is specified, the Termination Acknowledgement after the Action has been processed will be suppressed, and the follow-up action specified will be performed. The following options are possible:
opt * | N | NP param | T
* Execute the Actions and then display the Selection mask pre-filled with the information it last contained.
N Execute the Actions and then display an empty Selection mask.
NP param
Execute the Actions, followed by the specified NP command. The format of the param operand is described on page (Command NP).
T Execute the Actions and then terminate JES.
Set / Reset Auto-Copy Mode for new Join Entries
The Auto-Copy mode will be activated. This mode is exclusively used when creating or copying new Join entries with the Action Codes CU/AU, or with the AU command. When creating a new Join entry with one of the above Action Codes/Commands, the Join command will automatically be issued for all the pubsets in the list.
pvs Description of the Pubsets which should be encompassed by the Auto-Copy function. The Pubset identifier should be entered in the form A, 1, TEST etc.
The following strings have a special meaning:
*H Home PVS of the system
*D Default PVS of the relevant userid
A Standard Pubset table can be created in the JESMAIN module, which will be utilised if an ACOPY command is issued without parameters. For further information see the section entitled "Installation Options" on page ). Specifying a list of Pubsets in an ACOPY command allows the Pubset table to be amended dynamically.
An ACOPY command issued without parameters will result in the last valid Pubset being re-used.
NACOPY Reset Auto-Copy mode.
Standard: will be set by the system administrator in the JESMAIN paramater module.
AU The user will be presented with the following screen from which a new Join entry can be created:
The name of the new userid to be created should be entered in the USER-ID/PVS field, together with the required PVS-ID. The DEFCAT to MAILING fields contain default values, or are empty. The first Account number for the new Join entry should be entered in the ACCOUNT field. The CPU-TIME to CLASS fields contain default values. Only one Account number can be created for the Join entry with the AU command.
After a new Join entry has been sucessfully added, the Add User screen will be presented again, together with the attributes of the Join entry just created. These can be modified as required to create another new Join entry.
Pressing the K1 key will abort the Add User process. The next time the AU command is issued, the screen will contain the values last used.
The following commands may be executed from the command field in the Add User screen: ? (Invoke Help System), /cmd (BS2000 command), HC/NHC (Set/Reset Hardcopy mode).
Note:
The QD|NQD (Query on illegal Defcat) command should be noted in conjunction with the Add User command. With the default value of QD set, the user will be asked if the descriptor of a non-existent Default-Cat-ID really should be used.
NQD: The user will not be asked when entering a non-existent Defcat.
Extend the Join List with a new Selection
AL Append List. The Selection mask of JES will be displayed. The current Join list can be extended by selecting additional entries of the same type - User-/Account-/Mail-/SDF-specific .
AL param The USER-ID and other Selection mask fields will be filled using the values specified in param and the Join list will be extended immediately with the selected entries. The Selection mask will not be displayed in this case.
param The same values can be specified for param as in the NP command (NP param) . See page .
CFS [cmd] The CFS command has the same effect as the * and END commands, namely returning to CFS.
cmd CFS command which will be executed immediately after returning to CFS.
Example:
CFS OC1/LOGON XYZ,I001,'XYZ'
Delete a Join List saved to memory with SL (Clear List)
CL mn Clear List. The Join list saved by means of an SL mn command will be deleted, and the space reserved will be released.
mn is a 1 to 8 character mnemonic code which indicates the Join list previously saved with an SL mn command.
DOC Display the DOCUMENTATION field of the Selection mask.
DOC file Fill the DOCUMENTATION field of the Selection mask with the name of the file to be used directly.
The specified documentation file will be created when the user reaches the end of the Join list, and then presses the ENTER once again. Excuting a command A (execute Actions) will cause the documentation file to created immediately.
For further information regarding the DOCUMENTATION field, see page .
* | END Terminate JES and return to CFS. The command END can be used instead of * . END or * can also be entered from the Selection mask in order to terminate JES.
In CFS procedures, * indicates a commentary line, and hence cannot be used to terminate JES. The command END must be used in this case.
The next time that JES is called, the user will be returned to the same place as when the program was previously terminated.
HC [file] [, L] [, T] [, E] [, O] [, A] [, F] [, G] [, I] [, R]
Hardcopy mode will capture the screen input and output (particularly formatted screens) to a BS2000 file. All operands of the HC command are optional, and can be omitted. The default values will then come into effect.
The Hardcopy mode can be activated or deactivated as often as required (NHC command, see below).
Even without activating the Hardcopy mode with an HC command, the user can capture individual JES screens by pressing the F3 key. It should be noted, however, that each time the F3 key is pressed the captured screen will appear on a new page. The normal Hardcopy mode allows multiple screens to be captured per page, if required.
Saving a screen with the F3 key will have the same program execution effect as pressing the ENTER key.
For a full description of all of the HC command operands, see Chapter 15 "Hardcopy" of the CFS User Manual.
NHC Reset Hardcopy mode.
Display INF Text in the Display/Modify User Mask
INF The first three lines of the free-form INF text for a Join entry (see Action Codes I/IM on page ) will be displayed in the Display/Modify User mask. The displayed INF-Text can additionally be modified in the Modify User mask.
NINF The related INF text will not be displayed in the Display/Modify User (Standard).
Insert Action Code in all Action Fields
INSRT act The specified Action Code act will be inserted into the Action Field of all elements in the Join list. The window will be positioned at the beginning of the Join list.
Invoke the User Group Administration
JESG This command will cause control to be passed from JES to the User Group Administration program. A JES command can then be issued at any time to return to the main JES program.
Modify Mail Addresses with Lowercase Characters
LOW If existing Mail addresses contain lowercase letters, this command should be issued before that Mail address is modified with an M command (see below). This will prevent lowercase letters from being converted unknowingly to uppercase.
NLOW Lowercase letters in the Mail addresses will be converted to uppercase (Standard).
M All entries contained in the current Join list will be highlighted, and can be modified. The Modify mode will be reset when the ENTER key is pressed.
The command M offers the only possibility of amending Mail addresses in a Mail-specific Join list (User Option MAIL, see page ).
Modify Mail Addresses with Search and Replace Commands
M [n], [col] item1=item2 [, C] [A]
A search will be performed in the Mail addresses, beginning with the first Mail address displayed in the screen, for the search string item1, which will then be replaced by item2.
n Maximum number of Mail addresses for which the replacement function should be performed. Standard: no restriction of the number of addresses.
col Column range within which the search string must begin.
:col1-col2: The first character of the search string must be within the column range col1 and col2.
:col1: The search string must begin in col1 exactly.
Standard: The search will be performed across all columns in the Mail address range, i.e. from column 16 to 79.
The command SC (Scale) can be used to display a ruler in the MAIL list, which will make column ranges easier to count.
item1 Search string: C'string' | L'string' | X'string'
C'string' can be abbreviated to 'string' .
L'string': lowercase characters in string will not be converted to uppercase.
If string contains quotes ('), these must be entered twice ('').
item2 Replacement string: C'string' | L'string' | X'string'
C The C option (Change) will result in the search and replace operation being executed, together with the length of the strings being modified, if they differ. By default, (without the C option being specified) the replacement takes place simply by overwriting the search string with the replacement string. The length of the amended Mail address is not modified.
A All instances of the search string will be replaced within a Mail address (analogous to the EDT statement: @ON...CA'...'T'...'). Standard: Only the first instance found in a Mail address will be replaced.
If neither the C nor the A option is specified, then the first instance of the search string will replaced in each Mail address, where found.
Examples:
M,'WINTER'='HUBER',C
Beginning with the first Mail address displayed on screen, all the Mail addresses to the end of the list will be searched for the occurence of the string 'WINTER' . In each Mail address, the first occurence will be replaced by 'HUBER'. Since the C option has been specified, and the replacement string is one byte shorter than the search string, the remainder of the address is shifted to the left by that one byte.
M10,:36:''='!'
Beginning with the Mail address displayed on screen, the first 10 Mail addresses in the list will have the contents of column 36 overwritten with the character '!' . It should be noted that column 36 is the 20th column in the Mail address. The required column can be more easily calculated by displaying a ruler with a SC command.
Display the Join List with another User Option
NL [param] New List. Another User option will be displayed for the entries displayed in the current Join list.
param Specification for the new User Option, if necessary with a selection condition.
If nothing is specified for param, the JES Selection mask will be displayed. Additional Selection criteria for restricting the current list can be specified from here, in addition to a different User Option.
The user can restore the original Join list by issuing a RL (Restore List) command.
Examples:
NL ACCNB
An Account-specific Join list will be displayed for the current entries in the list.
NL TESTPRIV R>1
The Test privilege level will be displayed as a new User Option for the currently selected Join entries. In addition, those Join entries which have a Read privilege greater than 1 will be removed from the list.
NP New Parameters. The Selection mask will be displayed for the user to make a new selection of Join entries. The current Join list, together with any outstanding Actions will be deleted.
Pressing the K1 key has the same effect as entering an NP command.
A counterpart to this command is the AL command, which extends the current selection of the Join list.
NP param The USER-ID field and others in the Selection mask will be filled with the criteria specifiec in param . The selection operation will be performed automatically, and the resulting Join list displayed. The transaction step of completing the Selection mask is thus skipped.
The Selection criteria exist as a command in the Command memory, and can be recalled by pressing Shift and ENTER.
param [userid] [; pvs] [; keyw1=...] [; keyw2=...] [...]
Contents with which the fields of the Selection mask should be filled. The first positional parameter ( user-id ), will be used in the USER-ID field, with the second positional parameter ( pvs ) being used in the PVS field. All other parameters are keyword parameters and will be used in their respective fields.
The keyword parameters can be abbreviated. The shortest permissable abbreviations are shown below, together with the fields to which they correspond:
DEF --> DEFCAT
PUB-L --> PUBSPACE-LIMIT
PUB-U --> PUBSPACE-USED
AD --> ADDRSP
SE --> SEVER
PAS --> PASSWORD
SO --> SORT OPTION
U --> USER OPTION
DOC --> DOCUMENTATION
VAR --> VARIABLE ACTION
NP %name | %? [,jrsave] [,?] [;param]
The USER-ID field and other fields in the Selection mask will be filled with the contents of the specified Parameter set. The selection operation will be performed automatically, and the resulting Join list displayed.
%name Name of the Parameter set containing the selection criteria.
%? All the relevant Parameter sets will be displayed on screen, from which the required set can be selected by marking it.
jrsave Name of the JRSAVE file containing the specified Parameter set.
Standard: CFS.JRSAVE.xxxx. xxxx = Job name/Account number.
? The Selection mask will be pre-filled according to the contents of the Parameter set and displayed for the user to modify if required. Standard: the selection operation will be performed immediately.
param With the exception of user-id, the same values are permitted for param as for NP param (see above). the values specified for param will override the corresponding values in the Parameter set.
Examples:
NP TS
All Join entries whose userid contains the string 'TS' will be selected.
NP TSOS,Q
All Join entries belonging to TSOS (Qualified Selection).
NP TSOS,Q;B
The TSOS Join entry for Pubset B.
NP-TSOS;U=TESTPRIV R>3,W>3;VAR=ONXJOIN TESTPRIV=(3,3,YES)
All Join entries except TSOS which have a Read and Write privilege greater than 3. (USER OPTION : TESTPRIV R>3,W>3). With this NP command, a JOIN command to reset the Test privilege level will be issued in the form of a Variable Action (VAR=ONXJOIN TESTPRIV=(...) ). The execution of the Variable Action will take place after the required entries have been marked (see ON command, Action Code X).
Further Variations of the NP Command
NP; Select All Join Entries.
NP; is functionally the same as transmitting an empty Selection mask.
NP* This variation of the NP command will result in the Join list being reconstructed using the last selection criteria to have been used.
ONX... The Variable Action will only be executed for those entries in the Join list marked with the Action Code X. Marking the required Join entries in the list can be performed in the same transaction step as sending the ONX command. Alternatively it can be done afterwards.
ON&... The Variable Action will be executed for all the Join entries in the list, without them needing to be marked.
var-act The Variable Action specified here is identical to the form used in the VARIABLE ACTION field of the Selection mask, which is described on page .
Display the Public Disk Utilisation
PUBSP [pubset] [, FILE=file] [,SUM]
A screen will be displayed indicating the current public space utilisation of all available online Pubset volumes, or only of those specified.
pubset The space utilisation of the specified Pubsets will be displayed. The Pubset designator must be specified without the delimiting colons, e.g. A or TEST.
file The disk utilisation table will be saved to a file with the specified name. The screen display will be suppressed in this case.
SUM Only the summary line will be displayed for each Public Volume Set.
The PUBSP screen has the following format:
The following commands can be issued from the Command field of the mask:
/cmd any BS2000 command
+ | +n | ++ Position within the list
- | -n | -- Position within the list
HC file | NHC Set / reset the Hardcopy mode
PUBSP [pubset] additional PUBSP command for a particular Pubset.
F3 key Capture the contents of the current screen to the default Hardcopy file
K1 key Leave the PUBSP mask and return to the Join list
Display the Private Disk Utilisation
A screen will be displayed indicating the current space utilised on all available online private volumes.
priv The space utilised on those private volumes whose VSNs begin with the specified partial qualification. Example: PRIVSP PVT.
file The disk utilisation table will be saved to a file with the specified name. The screen display will be suppressed in this case.
The following commands can be issued from the Command field:
/cmd any BS2000 command
+ | +n | ++ Position within the list
- | -n | -- Position within the list
HC file | NHC Set / reset Hardcopy mode
PRIVSP [priv] PRIVSP command with another partial qualification
NP* Update the current Privsp list
F3 key Capture the contents of the current screen to the default Hardcopy file
K1 key Leave the PRIVSP mask and return to the Join list
Query User for Copy Account Overwrite
QCA | NQCA When copying or creating an Account number for a Join entry by means of an AA (Add Account) / CA (Copy Account) Action Code, the user will first be asked before an existing, identically-described Account number is overwritten.
Standard: QCA
Query User for Copy User Overwrite
QCU | NQCU When copying a Join entry by means of the AU/CU (Copy User) Action Codes, or by means of an AU command, the user will first be asked before an existing, identically-named Join entry is overwritten.
Standard: QCU
QD | NQD Query on illegal Defcat. The QD option will cause the user to be asked, when entering an illegal Default Catid, if a Defcat with this description should really be accepted.
NQD: No user query will be issued when entering an illegal Defcat.
Standard: QD
QRA | NQRA When removing an Account number from a Join entry by means of a RA (Remove Account) Action Code, the user will be asked if this Account number should really be deleted.
Standard: NQRA
Restore List: Display Previous Join List
RL [mn] Restore List. A Join list previously selected will be displayed again.
mn A one- to eight-character alphanumeric mnemonic (Mnemo Code) under which the Join list to be displayed had previously been saved with a SL mn (Save List) command.
If mn is not specified, the previous Join list to have been displayed will be re-activated.
The RL command issued without a Mnemo Code can be used at any time, even before an SL command (see below) has been issued.
Save List: Save Current Join List
SL mn Save List. The current Join list will be saved.
mn is a one- to eight-byte alphanumeric mnemonic (Mnemo-Code). This saved list can be re-activated by entering an RL mn command (see above).
S [-],'string' The next occurence of the specified search string will be sought in the Join list. The line containing the search string will be displayed as the first line.
For a full description of the Search command syntax, see the sections entitled "Searching for Text Strings (simple search arguments / complex search arguments)" in Chapter 8 of the CFS User Manual.
- Backward Search: The search will be performed from the first line displayed on the screen to the beginning of the Join list.
Standard (without '-'): The search will proceed from the first line displayed on the screen to the end of the list.
S [-] The next occurence of the search string defined in the previous Search command will be sought in the Join list. The option '-' will result in the search proceeding to the beginning of the list.
S? Display the last search argument to have been defined.
Note:
The SC command, see below, can be used to display a ruler above the Join list. This can be used to assist the user in determining the exact column or column range over which the Search command should operate.
Search the Join List and Display the Result on Screen
S,'string'=P A search will be made from the current position to the end of the list for the specified string. Entries containing the search string will be displayed on the screen in Line mode, and the search will continue. This form corresponds to the ON&P'....' EDT command.
After a maximum of 21 records have been displayed, an overflow control query will be issued ("Please acknowledge / End: K1"). Pressing the K1 key will terminate the search process. Any other input will cause the search process to continue.
After the search process has terminated, the Join list will be displayed again as it was when the Search command was issued.
Note:
After the results have been displayed, the search criteria will still be stored in memory. Entering the command S will position the window at the first entry which contains the search string.
Search the Join list and insert an Action Code
The Join list will be searched from the current position to the end of the list for the search string. The specified Action Code act will be inserted into the corresponding field for those entries containing the string. The search will then continue to the end of the list.
Instead of entering a simple search string in the form 'string', multiple search arguments can be specified and linked with */,/+ operators.
SC | NSC SCale/No SCale. A ruler or scale line will be displayed above the Join list. This is particularly useful when specifying Search commands which are column-specific. Default: NSC (no ruler).
SC file The ruler will consist of the first record of the specified file.
SC 'text' the ruler will consist of the text enclosed in the quotes.
Set Tabulator Stops in the Mailing Addresses
SET MAIL-TABS=t1 [, t2] [, t3] [, ...] [, t8]
Up to 8 tab stops can be set when processing Mail addresses. This enables rapid positioning between fields when modifying Mail addresses by using the tab key. The AFG (Delete) key will only affect characters up to the next tab stop. The values for t1 to t8 correspond to the columns within the Mailing address.
Default: no tab stops defined.
Display Action Code Field in a Mail-specific Join List
To enable easier processing of the Mail addresses, a 1 byte Action Code field can be displayed in a mail-specific Join list. Two Action Codes are then available for processing the entries, C(Copy), and O(Overwrite). The Mail addresses can then be processed similarly to lines in EDT.
Default: no Action Code field in the mail-specific Join list.
Check Job classes when copying
From OSD 3.0: The Job classes can be retained when copying a userid on the Home pubset.
Standard: Y, Job classes will be retained.
Amend Title in the Mail-specific Join List
SET M'text' A user-specific text string can be used as the title in the mail-specific Join list.
Standard: 'MAILING-ADDRESS'
Display Group Hierarchy of a PVS
The Group Hierarchy of the specified Public Volume Set will be displayed. The Group Hierarchy will be displayed as an overview in the following format:
The window within the mask can be positioned by means of the commands +, ++, +n, -, --, -n, >, >>, >n, <, <<, <n .
Pressing the K1 key will return the user to the Join list.
SO sort-opt A pre-defined value for the "SORT OPTION" field can be set. The Sort option determines the display order of the entries in the selected Join list.
sort-opt Sort Option. For a full description of these parameters, see Selektion Mask, "Sort Option" field, page .
SORT [sort-opt] The current Join list will be resorted. No new selection will take place. If no Sort option is specified, the resort will take place based on the last sort criteria to have been defined.
sort-opt Sort Option. For a full description of these parameters, see Selektion Mask, "Sort Option" field, page .
Example:
SORT PUBSP-U,D
The selected Join entries will be sorted in ascending order of used public space (Pubspace Used).
TAS This command will terminate JES and start Task Services. The user can return at any time by issuing a JES command.
UO user-opt A pre-defined value for the "USER OPTION" field in the Selection mask can be set. The User option allows an additional attribute to be displayed in the Join list.
user-opt User Option. For a full description of all User options, see Selection mask, "User Options" field, page .
Display Hidden Entries in the Join List
YANK All entries which have been hidden in the Join list by means of the "-" Action Code will be displayed in the list again.