|
General remarks regarding setting and resetting parameters
The commands described below - entered in the COMMAND field of the file list - serve to switch particular CFS functions on or off. The commands normally use the following convention: Resetting the command is achieved by prefixing the respective set command with an 'N' (No).
Examples:
HC Hardcopy <--> NHC No Hardcopy
DL Display Long <--> NDL No Display Long
H Hexadecimal Mode <--> NH No Hexadecimal Mode
A few commands also follow the EDT naming conventions. This results in more than one command to achieve the same function.
EL Edit Long <--> ELO Edit Long Off
LOW LOWer On <--> LOWO LOWer Off
SC SCale On <--> SCO SCale Off
SET Command: Amend CFS Parameters from a Screen Mask
SET A mask is displayed in which the most frequently used parameters can be amended for the current CFS session.
SET [%name | %? [,jrsave]]
The contents of the SET mask parameters will be modified according to the values contained in the specified parameter set. The display of the SET mask is suppressed.
Saving the current parameters to a parameter set can be achieved with the SP SET%name command. For further information, see page 7-.
The mask displayed as a result of the SET command has the following format.
With a mouseclick you get a describtion of the screen item.
All parameters can be set or reset using the individual commands as they appear in the SET mask (xxx/ yyy). If the individual commands are not to be set using the mask, they can be entered as parameters as they appear in upper case letters, e.g. "Display AGE/DATE" can be amended by entering AGE or DATE respectively. The commands to redefine the command memory and the escape symbol for connections are described under CRD (Connection Command Redefine) in Chapter 9, "Connection Handler (Sub-tasks under CFS)".
Not all parameters that may be amended in CFS have a field in the SET mask. These are generally system-specific parameters, and can only be amended using the CFS Modify command (M L'...',C'...'). For further information, see page 18-.
Setting user-specific parameters can be automated by entering the respective commands in a CFS Startup file.
Example for setting parameters in a Startup file:
*002 FILE=NO Switch to the command field in the next mask
UO EXTNT Define a default User Option
ALLOC Display the Allocated Space instead of Last Page
SO AGE,A Sort Option: sort the file list on ascending AGE
DUM Display Used Memory instead of the time
CP '&CON /' Connection Prompt: n / (n = Conn. Nr)
CRD -=§ Amend the command memory symbol used in Conns.
NP Return to the CFS Selection mask
For a full description of the automated Startup facilities of CFS, refer to Chapter 19 "Procedure Language", and Chapter 20 "Startup".
AC | NAC Add Compressed/No Add Compressed.
AC Store files in compressed mode as elements in LMS ISAM libraries.
NAC Store files in umcompressed mode as elements in LMS ISAM libraries.
Standard: AC (compressed storage).
ADOC | NADOC Automatic Documentation File / No Automatic Documentation File
ADOC every time a new file or library element list is created (by returning to the Selection mask, or through the NP command), the old list is saved to a temporary file.
Standard: ADOC.
Notes:
The name of the file will be #CFS.SAVELIST.jobname, or if no Job name is specified in the LOGON command, #CFS.SAVELIST.acct-nr. The default prefix of #CFS.SAVELIST. can be amended by the system administrator.
Entering RL ((Restore List) in the FILENAME-SELECT field will re-display the old file list.
The RL command can be used to alternate the display between the last and the current file list. This is a quick way of processing two separate file lists.
File List: Display the last amendment as a number of days
AGE Age descriptions, and in particular the Age column in the file list, will be displayed as the number of days. This field can also be displayed as a date, by using the DATE command. Switching form one mode to the other will only become operable at the next selection. Instead of AGE, the command NDATE can be used instead.
Standard: AGE.
Increment Version number when adding an existing element to LMS or PLAM libraries
AI | NAI Add version Increment / No Add version Increment.
AI Automatic Version increment when ADDing to an LMS library (ISAM or PLAM): If the element being added already exists in the library, the version description will be incremented by 1 when the new element is added.
NAI When ADDing to an LMS library, if an element of the same name exists, the element with the highest version number will be overwritten. This is not true, however, if the element exists in Delta storage format in a PLAM library. In this case, the version number will be incremented by 1, even if NAI mode is set.
Standard: NAI.
File List: Display Allocated Space as File Size Indicator
ALLOC The space allocated to a file (in PAM pages) is displayed in the first coulmn of the file list as the measure of the file size.
Normally, the number of occupied PAM pages (LASTP) are displayed as the file size indicator. Changing from one method to the other will only take effect at the next file selection.
AMC | NAMC Automatic Memory Compression/No Automatic Memory Compression.
AMC All of the CFS-internal memory areas (FILENAME-SELECT, COMMAND, Connection 0, ..., 9) consist of a 4096 byte table into which the keyboard entries are sequentially stored. When the table is full, the entries are cyclically overwritten from the beginning. To increase the available storage, a memory compression routine can be run internally. This memory compression routine deletes duplicate entries from the tables, thus freeing up space. The sequence of the entries in the table following the compression will not correspond to the actual sequence as entered. Standard: AMC.
For further information on the Command Memory, see also the CM (Compress Memory, page 7-), SM (Save Memory, page 7-) and LM (Load Memory, page 7-) commands.
Assign Printer for PDxx Action Code
APD device Define or amend an existing printer device name which will be defined in the PDFILE with a mnemonic code and a virtual device name '????????'. If the virtual device name '????????' has not been assigned to a real device with APD, the printer name will be requested the first time that mnemonic code is called. For further information, see the CFS System Administrators Manual, "PDFILE" section.
CFN | NCFN Complete Filename. The names of the files and Job variables are displayed in the file list in a full, FSTAT compatible form. This means that the catid and userid of the files are always displayed. The system administrator can set the default CFN mode in the CFSMAIN module.
NCFN No Complete Filename. The standard format for displaying file names in CFS is used. The catid and userid of a file is only displayed if it is necessary to distinguish the file from another already in the list.
CH k-desc Connection Hardcopy. The hardcopy mode can be activated for individual CFS screens by pressing the F3 key. However, in Connections, the F3 key may already be used by an application function. Because of this, the user can assign any F or K key as the hardcopy key by means of the CH command.
k-desc Key description: K1, K3, ... ,K14 / F1, ... ,F20.
Standard: NONE (no key will activate the hardcopy function in Connections).
Notes:
A hardcopy of a mask taken under control of a key defined by the CH command will result in the data entry being lost. It must be re-entered and transmitted with DUE1/ENTER.
It should also be noted that when capturing screen masks with a key defined with the CH command, each mask will appear on a new page if the file is printed with SPACE=E. This is in contrast to the normal hardcopy mode (set witth the HC command), which offers the possibility of printing multiple screens per page.
Amend the BS2000 Prompt in Connections
CP 'param' The system prompt for BS2000 commands in CFS Connections can be set to any string. These can even be variables, such as the date, time, userid or name of host system. Standard: '/'
param String for the BS2000 prompt in Connections. param may not exceed 60 characters. Lower case letters will not be converted to upper case. Variables can also be used in param as well as constants. At the time the prompt is displayed, the current value of the variable will be substituted. The name of a variable must be terminated with a special character, such as a blank or a comma. If a letter or numeral is to appear after the variable as a constant, the name of the variable should be terminated with a full stop. The full stop will not appear in the text. The following variables can be used:
&CON Connection number under which the user is currently working.
&USER-ID Userid under which the user is currently working in this Connection.
&LOGNAM Job name specified in the LOGON command for this Connection.
&HOST Name of the host system on which the dialog task is running.
&DATE Current date in the form dd.mm.yy
&TIME Current time in the form hh:mm
&(jvname) Contents of the specified Job variable
Notes:
The Connection Prompt will operate in all Connections to $DIALOG, so long as the SDF Option GUIDANCE= MIN | MED | MAX is not being used.
If the CP command is contained in a Startup file, and if variables are used, the following command sequence should be used to prevent conflicts with CFS procedure variables:
*SET PAR=#
CP ' ... '
*SET PAR=&
If the CP command is contained in a Startup file, then the hexadecimal mode of EDT can be used to enter Line Mode control characters to offset text strings in the CP command. For further information, see the "Executive Macro Calls" manual, VTCSET macro.
Example: CP 'x&CON:y &HOST $&USER-ID &TIME x->'
In the above example, x represents the Line Mode control character X'14' (EM4), and y represents the code X'1F' (EM2). Entering this CP command will display the following prompt:
1: VAR2 $TSOS 10:22 ->
When operating nested Connections (see page 9-), the Connection prompt of the latest copy of CFS to have been loaded will always be valid.
Examples:
CP 'Please enter next command >'
CP 'Conn. &CON &USER-ID &TIME /'
For example, if the user logs on to the userid TEST, the following prompt will be displayed:
Conn. 1 TEST 13:22 /
Close the Display File after each User Input
CA | NCA The Display File will be closed following each user input. The file will thus be locked only very briefly while scrolling etc, and for most of the time can be opened for reading or writing by other users.
Standard: NCA
Notes:
CA mode is not operational when modifying files (Modify), i.e. the file reserved for modification will remain locked to other users (in write mode) until the Modify mode is terminated.
The CA mode is also invalid in Single Record mode (SR), as well as when displaying tape files.
Terminating the Display mode will not reset the CA mode. It will remain in effect until it is reset by an NCA command.
CAP CFS Editor: When modifying files, lower case characters will be converted to upper case before the file is written away.
File Documentation (Action Code IM): The information text will be converted to upper case.
Search command, FIND User Option, ONXFIND Variable Action: Search arguments ([C]'item') will be converted to upper case.
The command LOWO (LOW Off) is equivalent to CAP. The conversion of lower case to upper case is prevented by the LOW command.
Action Code EDT: When reading in a new file or library element, if LOWER ON mode of EDT was set, it will automatically be reset (LOWER OFF).
CSO [STAT] | NCSO Compress Screen Output on/off. the screen contents created by CFS in Connections will be compressed before it is displayed, and hence before it is transmitted. The compression is achieved by replacing repeating characters with special control characters. (WDH sequences). To achieve optimum compression rates, the CFS file lists are displayed in a slightly modified form. Before CFS is terminated, a message will be displayed containing the compression statistics.
STAT The current compression statistics will be displayed in the system line.
NCSO No Compress of Screen Output. The screen compression will be disabled.
Standard: NCSO.
Check Element Types when adding Elements to PLAM Libraries
CT | CTQ | NCT Check Types/Check Types and Query/No Check Types. A type check will be made when adding elements to PLAM libraries.
CT Only the LMS-compatible element types C/D/H/J/L/M/P/R/S/X are allowed.
CTQ When adding LMS-incompatible element types, the user is asked whether the element should really be added as that type.
NCT No type check when adding elements to PLAM libraries.
Standard: CTQ.
File List: Display the Last Access in Date Form
DATE The specification of age, in particular the AGE column in the file list, will not be displayed as a number of days, but rather in date form (dd.mm.yy). The command NDATE (or AGE) will reset this mode to the default value. The mode will only be operational after the next selection. Standard: AGE.
DOC Display the DOCUMENTATION field of the Selection mask.
DOC file Insert the specified name directly into the DOCUMENTATION field.
For further information, see the description of the DOCUMENTATION field on page 4-.
Display DO Parameter Mask for Procedures
DP | NDP Do Parameter mask/No Do Parameter mask.
DP When entering a BS2000 DO command in the File list command field, or in Connections, an analysis will be made of the PROC statement in the DO procedure. If it is found to contain DO parameters that have not been assigned, a parameter mask will be displayed. The missing parameters can then be entered.
Standard: DP.
Note:
The parameter mask will also not be displayed in DP mode if the subtask is running under a different userid to that from which CFS was loaded, and the procedure is not shareable. It will also not be displayed if the Connection is operating on a different host system to that of CFS.
Instead of displaying the current time (hh:mm:ss) in the file list mask, the system resources utilised in the last transaction will be displayed.
M Display Used Memory. The amount of Class 6 memory being used will be displayed.
CPU Display Used CPU Time. The amount of CPU time used since the last screen output will be displayed.
WSI Display Used Working Set Integral. The value of the Working Set Integral since the last screen was output will be displayed. The Working Set Integral is defined the product of the number of main memory pages used and the CPU time used.
IO Display Used IO's. The number of disc IO's used since the last screen output occurred will be displayed.
NDU The current time (hh:mm:ss) will be displayed instead of utilised system resources.
Standard: NDU.
Duplicate Key Mode in CFS Editor
DUPK | NDUPK DUPKEY mode on/off. When processing ISAM files, duplicate keys are allowed/not allowed. In DUPK mode, ISAM records with identical keys may be created with Move and Copy operations (see page 8-: Moving/Copying ISAM records). ISAM records with duplicate keys can also be created in DUPK mode using the IR (Insert Records) command (in particular with the K option: key-permitted insertion). The DUPK mode will also work with the W command for ISAM files: the same records (ISAM key) can be written repeatedly to the file.
Standard: NDUPK.
Automatic Commands after calling EDT
After reading in a data object with the EDT[n] Action Code, or with the EDT command, the specified EDT initialisation commands will be executed.
cmd One or more EDT commands. Multiple commands must be separated with a semicolon (;). Example: EDTINIT LOWER ON;PAR EDIT-FULL=ON
Standard: No user-defined EDT commands will be executed.
Notes:
If multiple data objects are read into different EDT workfiles (EDT[n] Action Code), the EDTINIT command will be executed individually for each workfile.
An EDTINIT command issued without parameters will reset any previously defined initialisation commands.
Erase and Retain Temporary Files
ERT | NERT Erase Retain Tempfiles/Erase No Retain Tempfiles.
ERT The ERT mode results in those files/Job variables/library elements to be erased with Action Code E first being recataloged to temporary files or libraries. These temporary files will automatically be erased by BS2000 at the end of the task. From the users point of view, all those files erased with Action Code E still exist as physical files until the end of the task (they can be accessed by entering FSTAT #, or STAJV # in the FILENAME-SELECT field).
The name of the temporary file is constructed by prefixing the original name with the temporary file indicator (normally the # character), during the CAT command. Naturally this means that the ERT mode is inoperable when explicitly erasing temporary files.
Library elements will be copied as an identically named element to a temporary library before being erased. They will remain available until the end of the task. The name of the temporary library will be created, as for files, by prefixing the library name from which the element was erased with a # character.
The ERT option will not take effect if the files are erased with the Action Codes ED (Erase...,Data), EC (Erase ...,Catalog) or EN (Erase No Retain Tempfiles). The ERT option will also not work for files larger than 500 PAM pages residing on private volumes.
Deleted data objects are automatically removed from the file list (implicit '-' Action Code). The YANK command can be used to restore those files to the file list.
The ERT mode is set by default.
NERT The ERT mode is disabled with the NERT command (No Erase Retain Tempfiles), or using the SET mask.
HC [n] [file] [, L] [, T] [, B] [, E] [, O] [, A] [, F] [, G] [, I] [, S] [, R]
Activate the Hardcopy Mode for the basic CFS task, or for Connection n.
When the Hardcopy Mode is set, all screen input and output (particularly masks) will be captured to the specified file.
All HC command operands are optional, and can be omitted. The default values will then become effective.
The Hardcopy Mode can be turned on and off as often as required (see below for the NHC command).
Apart from activating the Hardcopy Mode explicitly with the HC command, individual screens can be captured by pressing the F3 key (in the base CFS task), or by pressing the pre-defined Hardcopy key (in a Connection, see the CH command on page 18-). It should be noted that each screen captured with F3 will appear in the listing on a separate page. This is in contrast to the normal Hardcopy Mode (HC command), in which multiple screens can be printed on a page.
Entering a CFS mask with the F3 key will be handled identically to DUE1. When working in a Connection, if the specially defined Hardcopy key is pressed, the latest input is lost. It must be re-entered, and transmitted with DUE1.
The HC command works only in the basic CFS task, and will not work in Connections. An HCn command must be given for a Connection. Hardcopy Mode can be activated for a Connection even before it has been opened. Within a Connection, the Hardcopy Mode can be requested via the HC command.
For a full description of all HC command operands, see Chapter 15 "Hardcopy".
NHC | NHC n Reset Hardcopy Mode for the CFS basic task / for Connection n.
File Information System: Standard Format for entering INF Text
I FORM=f This command can be used to enter a user-specific format f into the format catalog, $TSOS.CFS.INF.FORMAT, which will serve as the standard format for entering text (IM/IA Action Code, without specifying a format). For further information, see Chapter 13 "File Information System".
Add to Libraries: Create Initial Element Version
IV | NIV Install Version/No Install Version.
IV When adding elements to FMS libraries for the first time, it will be created as an initial version (Delta storage).
NIV If the element being added to the FMS library does not yet exist, the element will not be added as an initial version.
Standard: NIV
Activate/Deactivate Job Report
JR [jr-id] Activate Job Report System.
NJR Deactivate Job Report System.
Standard: JR.
For further information on the Job Report System, and all commands beginning with JR, see Chapter 11 "Job Report System", page 11-.
Activate Job Report after Termination of File Transfer Requests
JRFT The JRFT command will cause all following FT requests started from CFS being linked with a Monitor Job variable. Prerequisites are FT-BS2000 Version 3.0 or above, and the PROTOCOL-LISTING parameter being set to YES in the parameter mask. This will result in the protocol being displayed on screen by the Job Report System after the transfer has finished.
NJRFT File Transfer requests will not be linked with either a Monitor Job variable or, therefore, with the CFS Job Report System. This also applies if the default value of NO is left in the PROTOCOL-LISTING parameter of the File Transfer Parameter mask.
Standard: JRFT for PROTOCOL-LISTING : YES
JREP enter-params Job Report Enter Parameters. All Enter jobs started with the Job Report System will use the specified parameters for the Enter command.
enter-params All parameters permitted in the BS2000 Enter command may be specified. These parameters will then be used as the default values for all following E commands. The Enter parameters predefined with the JREP command can be enhanced with further parameters in the E command and/or in the parameter mask for DO procedures.
Enter parameters can also be entered in the JRP mask (JRP command, see below).
JRF SYSOUT | SYSLST | jr-file
Define Job Report File. The file that will be displayed after the job has finished is defined here. The JRF definition will remain valid for all following jobs. The Job Report File can also be specified as an E command parameter or in the JRP command.
Standard: SYSOUT.
JRIC cmd Job Report Initial Command. Any valid command from the Job Report mask (+/-/++/S,...) can be specified for cmd. The specified command will automatically be executed in the Job Report following termination of the Enter job. The JRIC can also be specified in the JRP command.
Standard: no Initial Command
JRID jr-id Define a user-specific Job Report Identification. The JRID can also be specified in the JRP command.
Standard: Account number.
JRSH | NJRSH Set SHARE=YES or NO for the Job variables and files created by the Job Report System. Standard: NJRSH (SHARE=NO)
JRP Job Report Parameters. A mask will be displayed in which the current values for JRID, JRF, JRIC, JREP and JRSH are shown. These values can be amended, and will then act as defaults for all following Job Report functions.
KC | NKC Keep Command /do Not Keep Command.
KC The command last entered will not be erased from the command field.
NKC The command last entered will be erased following successful execution.
Standard: NKC
For information about "Repeat Last Command", see also page 7- (Command Memory).
File List: Number of Used Pages as File Size Indicator
LASTP The file size indicator in the first column of the file list is normally the Last Page, i.e. the number of PAM blocks actually occupied by the file. Switching the mode using the ALLOC command will only take effect at the next file selection.
Standard: LASTP.
Log [Do Not Log] Entries in Command Memory
Log Input in Memory (LIM) / do Not Log Input in Memory (NLIM).
LIM All user entries (selection mask parameters, commands, Line Mode input in Connections) will be stored in the internal command memory (Default).
SEL Selection mask entries are logged in the memory.
CMD File list entries ("COMMAND :" field) are logged in the memory.
CON Input made in Connections is logged in the memory.
NLIM All input following this command will not be stored in the command memory, and hence will not be available for reuse when pressing the DUE2 key. The NLIM command is particularly relevant in CFS procedures, so that the entries produced by the procedure will not be stored in the memory.
SEL Selection mask entries are not logged in the memory.
CMD File list entries ("COMMAND :" field) are not logged in the memory.
CON Input made in Connections is not logged in the memory.
Notes:
The CFSMAIN initialisation module can be used to specify which entries are logged in memory.
For further information regarding the command memory, see page 7-.
No Lower Case to Upper Case Conversion
LOW CFS Editor: When in Modify mode, lower case letters are not converted to upper case.
Entering File Documentation text (IM Action Code): The text will be passed as entered in lower or upper case.
Search Command, FIND User Option, ONXFIND Variable Action: No converson from lower case to upper case will take place in the search argument. This can also be achieved by entering the search argument in the form L'....' .
EDT Action Code: When reading in a new file or library element, the LOWER mode of EDT is not changed. A LOWER ON command entered for a previous file will thus remain in effect.
Standard: CAP
M L'addr', C'string' | X'string'
This command can be used to modify the standard values for the currently loaded CFS program. The Modify command is a substitute for the IDA command, /M C'...' INTO L'...', that could be called from TSOS by a single user. The Modify command should only be used to amend CFS-internal parameters which have no specific CFS modification command.
L'addr' Address of the location to be modified in the loaded program. The parameter addresses can be ascertained using the CFSMAIN source program. For example, the Assembler command MVI 33(R1),C'Y' corresponds to M L'1021',C'Y' (L'1021' = L'1000' + 33) in CFS Modify syntax. All CFS-internal parameter addresses in CFSMAIN will be maintained in future versions of CFS.
C'string' | X'string' The content to be copied to the specified address.
Examples:
M L'1031',X'00'
The contents of the memory location L'1031' will be reset to X'00' as a result of this statement. This will result in no lower case to upper case conversion taking place when capturing a CFS mask using the Hardcopy function.
The character string 'CFS.JRSAVE.name___' will be written to memory as from address L'12E5'. This will change the default JRSAVE file name, for example for a second user.
Query User before Overwriting etc.
QE | NQE Query/No Query on Erase.
To prevent erasing files accidentally when using the E Action Code, the user can be forced to confirm each deletion before the deletion is actually carried out. Standard: NQE (No Query on Erase).
Refer also to the CFS ERT (Erase and Retain Tempfiles) parameter.
QA | NQA Query/No Query on Add.
Before carrying out an ADD operation for an element that already exists in a library, the user is asked if the existing element should really be overwritten: ".... IS ALREADY IN LIBRARY - OVERWRITE ? (Y/N/YA/NA)". During the execution of a Variable Action, answering YA (Yes,All) will overwrite the current element, and all following elements. No further queries will be generated, and Yes will be assumed. Analogous to this is the answer NA (No,All). The YA/NA mode will be reset after termination of the Variable Action.
Standard: NQA (No Query on Add).
QC | NQC Query/No Query on Copy.
Before a copy is performed to a file, JV or library element that already exists, the user will be asked if the existing data object should really be overwritten, as follows: "... IS ALREADY IN CATALOG - OVERWRITE ? (Y/N/YA/NA)". During the execution of a Variable Action, answering YA (Yes,All) will overwrite the data object, and all following objects. No further queries will be generated, and Yes will be assumed. Analogous to this is the answer NA (No,All). The YA/NA mode will be reset after termination of the Variable Action.
Standard: NQC (No Query on Copy).
QR | NQR Query/No Query on EDT-Return.
QR CFS Command EDT/EDL: After terminating EDT, the user is asked if the virtual EDT memory should be deleted (@D).
Action Codes EDT/EDL: The virtual EDT memory will automatically be deleted following the successfull execution of the UPD Action Code.
NQR The virtual EDT memeory is not deleted following a UPD Action Code; the user will not be queried for @D after returning to CFS from EDT.
Standard: QR.
QS | NQS Query/No Query on Select.
Before a Select is performed to a file that already exists, the user will be asked if the existing file should really be overwritten, as follows: "... IS ALREADY IN CATALOG - OVERWRITE ? (Y/N/YA/NA)". During the execution of a Variable Action, answering YA (Yes,All) will overwrite the file, and all following files. No further queries will be generated, and Yes will be assumed. Analogous to this is the answer NA (No,All). The YA/NA mode will be reset after termination of the Variable Action.
Standard: QS (Query on Select).
QT | NQT Query/No Query on Term.
Before terminating CFS, the user is asked: "Do you really want to terminate CFS ? (Y/N)". Standard: NQT.
QL | NQL Query/No Query on Lock.
Before the screen lock becomes effective, the user will be asked: "Do you really want to lock your screen ? (Y/N)". Standard: NQL.
Q equivalent to QE;QA;QC;QT;QR.
NQ equivalent to NQE;NQA;NQC;NQT;NQR.
SC | SCO SCale/SCale Off. A ruler will be displayed in the top half of the screen as a column counter. This ruler will be displayed in the file list and in Display mode. The commands OL/NOL (Orientation Line/No Orientation Line) can be entered as equivalents to SC/SCO.
Standard: SCO (no ruler).
Display Connection Status in 25th Line
SCL | NSCL Show Connection Line.
When the user is in a Connection, an overview of the most important Connection parameters will be displayed in the 25th line. These include the Connection number, the application name, the virtual terminal name, the host name, and the userid (only for $DIALOG Connections).
Standard: NSCL
Note:
The Connection Line gives the user a permanent overview of the current Connection information. This is particularly useful for UTM and DCAM applications, since the Connection Prompt (see CP command) cannot be used as for $DIALOG.
PLAM Libraries: Determine Age from "System Date" Directory Field
SDAT PLAM Libraries: The Age indicator in an element list will be determined from the System Date (=date of last update), over which the user has no control. Standard: UDAT
Note:
When reorganising PLAM libraries, the System Date will be set to the current date (AGE=0) for all elements. The element User Date will not be amended during reorganisation. To maintain relevant age indicators even during library reorganisation, use the UDAT parameter (see page 18-).
Amend Separator Symbol for CFS Commands
Multiple commands can be chained in the CFS command field. The individual commands are identified from one another by the Separator symbol ";".
In addition, the separator symbol is used for
- Separating keyword parameters in *001/*002 records (see Chapter 19, "CFS Procedure Language"),
- Separating keyword parameters in the NP (New Parameters) and AL (Append List) commands,
- Concatenating multiple User Options in the respective Selection mask field, or in the OU (Standard User Options) command.
The separator symbol can be redefined using the SEP command.
SEP x x is the new separator symbol. The SEP command may not be chained with other commands.
SEP ? displays the current separatpr symbol. Refer also to the respective field in the CFS SET mask.
Define Standard Sort Option for File Lists
SO { AGE | NAME [(o,l)] | SIZE | USER | NONE } [, A | D ]
The file list is normally sorted in ascending order on name (Standard sort criterion). Using the SO command, the user can define another field as the primary sort key, as well as the order (ascending/descending). Identical primary keys will then automatically be sorted in ascending name order. The SO command will enter a value in the SORT OPTION field of the Selection mask. Entering another value in the SORT OPTION field (see page 4-) will have a temporary effect, and will not affect the standard sort criterion set by SO. For additional information on sorting the file list, see also the SORT command on page 7-.
AGE The file list will be sorted according to the value in the AGE or DATE column. For PLAM libraries, the time of the last amendment (TIME) will be taken into account for the sort.
NAME [(o,l)] The file list will be sorted according to the full file or element name (Standard). The (o,l) option can be used to sort on a portion of the name. o represents the offset, and l the portion length. Standard: NAME(1,44).
Example: By using the Sort Option NAME(3,40), a list of PLAM library elements can be sorted whereby the elements with the same name but different types follow one another.
SIZE The file list will be sorted on the first column (LASTP or ALLOC for files, SPACE for libraries).
USER If a USER OPTION was specified during file selection, then entering USER as a Sort Option will result in the list being sorted on this characteristic. If no USER OPTION was specified, this Sort Option will not have any effect.
NONE The file or element list will be displayed unsorted.
A Ascending sort order (Standard).
D Descending sort order.
SO? The current Sort Option will be displayed.
SPL [passw] Set Password for Lock. A password for a future LOCK command is defined. If passw is not specified in the SPL command, the user can enter it in a blanked field later.
The SP Action Code is also applicable in BS2000 systems with password encryption (ENCRYPT=YES). Removing passwords for protected PLAM library elements is possible under LMS Version 3.0.
SPREL The password entered in the password table by the SP Action Code for the file, PLAM element or Job variable marked in the list will be removed (PASSWORD ...,REL=Y).
PLAM Library: Determine Age from the "User Date" Directory Field
UDAT PLAM Libraries: The Age indicator in an element list will be determined from the User Date. Standard: UDAT.
Notes:
When reorganising PLAM libraries, the Creation Date of all elements will be set to the current date (AGE=0). The User Date of the elements will not be affected by the reorganisation. To maintain relevant age indicators even during library reorganisation, use the UDAT mode.
When adding a file as an element to a PLAM library, CFS will set the element User Date to the file creation date. This can result in newly-created elements appearing in the file list (in UDAT mode) with an AGE > 0. The time column (time of the last amendment) will be set to 00:00, since TSOSCAT maintains only a creation date, and not the time.
Assign another Library as Userlib
UL library The specified library will be used with immediate effect as the CFS userlib. Information regarding the current userlib can be had from the SET mask; assigning a new library can also be done from here.
Standard: CFS.USERLIB (own userid)
For further information about the CFS userlib, see Chapter 21 "Userlib".
Define Standard User Options for the Selection Mask
UO [u-opt-1] [; [u-opt-2]] [; [u-opt-3]] [; [u-opt-4]]
The specified User Option(s) will be used with immediate effect as the default values for the CFS Selection mask. Information about the current default User Options can be obtained from the SET mask; assigning different options can also be done from this mask.
Standard: no default User Option.
Notes:
User Options result in one or more freely selectable file characteristics being displayed in the file list, in addition to the standard CFS values. The user can enter a condition to select files on the basis of these characteristics. Multiple User Options should be separated by semicolons. A maximum of four User Options can be specified.
Entering the UO command without operands will reset the last Standard User Options to have been defined.
The UO command may not be chained with other commands.
The value for the first User Option to have been specified will be displayed in the special User Option column. Second, third or fourth User Options will overwrite the PASS, AGE and LASTP (SPACE) columns, respectively.
Two successive semicolons, ";;" , will result in that respective column not being overwritten with a User Option. See the last example on this page.
A User Option defined with UO will first be operable after the next selection. To activate a new User Option for the current file list, use the NP* command. NP* will not display the new User Option if the current selection already contains another User option.
Examples:
ALLO2;ALCNT;EXTNT;ALLOC
The User Option column will display the secondary space allocation (ALLO2). The PASS column will contain the number of utilised secondary allocations, the AGE column will contain the number of extents (EXTNT), and the LASTP column will contain the allocated disk space (ALLOC).
ALCNT;EXTNT;;ALLOC
The User Option column will contain the number of utilsed secondary allocations (ALCNT), and the PASS column will contain the number of extents (EXTNT). The AGE column will not be overwritten (;;). The LASTP column will contain the allocated disk space (ALLOC).
Define Standard User-ID for Selection
UID [ :x: | :*: | user-id | :x: user-id | :*: user-id ]
The specified userid will be used with immediate effect as the default value in the Selection mask. Information about the current standard userid can be obtained from the SET mask; assigning another userid can also be done from here.
user-id Select files from the specified userid on the default Pubset. The userid should be entered without the $ and following fullstop.
Standard: no default userid.
Notes:
Entering the UID command without operands will reset the last Standard Userid to have been defined.
A userid defined with UID will only become operable at the next selection.
Display/Set the VARIABLE ACTION Field in the Selection Mask
VAR Display the VARIABLE ACTION field in the Selection mask.
The user has two lines in which to enter the required Variable Action.