|
Select all files to be transferred with FT (NSTAT)
NSTAT [*ALL | owner] [, remsys]
All files or PLAM library elements to be transferred to or from the local system with FT-BS2000 will be selected. The selection will take place only for those objects whose transfer has not finished.
If neither the *ALL nor the owner option is selected, all FT requests under the current userid will be selected. For the system administrator, this means the TSOS userid.
*ALL FT requests from all users that have been started, but that have not yet finished, will be selected.
owner FT requests from a specific user that have been started, but that have not yet finished, will be selected. Any user may be specified for owner. The userid must be specified without the $ and full stop, e.g. TSOS .
remsys All FT requests to the specified partner system will be selected.
Note:
For information regarding "Selection using the NSTAT option", see page 4-. For information on the additional File Transfer possibilities under TSOS, see page A1-.
Selection Field : USER-ID
Select Files / Job Variables from all Userids
(JOIN) | () | [:x:|:*[*]:] ( )string
(JOIN) All userids and all Pubsets (PVS) will be searched for files or Job variables that match the specified criteria. The abbreviation () may be given instead of (JOIN).
:x:(JOIN) All userids on the specified Pubset (PVS) will be searched for files that match the specified criteria.
:*:(JOIN) All locally available Pubsets and all userids will be searched for files that match the specified criteria.
:**:(JOIN) All pubsets in all local and remote userids will be searched for files with the specified characteristics.
()string | [:x:|:*[*]:] ()string
Those userids that contain the specified string within their name will be searched for files that match the specified criteria.
Example:
()UTM
All userids that contain the string UTM somewhere within their name will be searched.
Notes:
Normally, CFS will display the following message for each userid in which no files were found: "NO FILES FOUND FOR USERID xxxxxx". These messages can be supressed if task switch 4 is set (/SETSW ON=4). It can also be suppressed if the system administrator sets an indicator in PAM page 4 of CFS, or in the CFSMAIN module (For further information, see the source listing of CFSMAIN).
In order to keep the search times reasonable, the JOIN function can be combined with the NO (Names Only) User Option. For a full description of the NO User Option, see page 4-.
The file list will be sorted by userid according to the condition specified in the SORT OPTION field. The full list can then be sorted by entering a CFS command, SORT sortopt.
USER-ID : (JOIN) may not be specified in conjunction with the USER OPTION : OPEN .
[:cat-with-wildcard:] [user-id-with-wildcard]
cat-with-wildcard
Cat-ID selection following the FSTAT (SHOW-FILE-ATTR) syntax.
The construct <x:y> may may not be specified.
user-id-with-wildcard
User-ID selection following the FSTAT (SHOW-FILE-ATTR) syntax.
Example:
:C/<1,2,3>:SYS*
This example will result in the selection of all userids beginning with SYS. In addition, all catid's which begin with C, which have any character as the second character, and which have a 1, 2 or 3 as their third character will be selected.
(file) The USER-IDs will be read from the specified file. The file must have the attributes Recform=V and Fcbtype=SAM .
Example:
A file CFS.USER contains 5 records as follows:
:G:TT08
:OPG:TT08
CFS
:1:TSOS
:2:S43
By entering the following selection conditions:
NPSAP;(CFS.USER)
all files containing the string 'SAP' in their name existing under the userids :G:$TT08. / :OPG:$TT08. / $CFS. / :1:$S43. or :2:$S43. will be selected.
Selection Field : USER OPTION
Select all open files in the system / all files with a specific link name
OPEN This User Option will display all files currently open in any mode throughout the system, as well as those files not yet open, but assigned with a link name. The selection will take place using the Task File Table of all TSNs. The User Option can only be executed from TSOS, and uses SVC 79. This User Option can also be made available to non-TSOS users in a restricted form, if the system administrator has first started a CFS Holder task under TSOS (/ENTER CFS.S.LMSLIB(CFSHT) ). For further information, see page A1-.
In addition to the TSN and the Open mode, the number of IO's used for each file during a predefined time interval can be displayed.
Selection parameter: [S,] [I|O|E|N|PR|SEC[EX]|ALL] [,TSN=tsn] [,USER= user-id] [,POOL=isam-pool] [,LINK [=link]] [,D-IO[S]|A-IO[S] [><=x] [,INT= sec] [, RW] ]
S in addition to user tasks, files opened by system tasks will also be displayed. The S option alone is equivalent to IOEN,S. Specifying OPEN S will display all active and inactive TFT entries.
I all files opened as Input
O all files opened as Output, Outin, Inout, Update, Extend
E all files opened as Exec (loaded programs, SDF Syntax Files)
N all files assigned, but not yet open or no longer open (inactive TFT entry)
PR all files locked with a PRINT command (PR ...,LOCK=YES)
SEC all files reserved with a SECURE command, either shareable or exclusively
SECEX all files reserved exclusively with a SECURE command
SECEX is a subset of SEC (see above)
ALL abbreviation for the input IOPRSEC
Abbreviation for IOENPRSEC, if the parameter TNS= is specified.
Standard: IOSECPR
The options I O E N may be specified in any combination (e.g. IO / IOE / IOEN).
TSN=tsn
Display all TFT entries relating to the specified TSN. The description of a system task can also be specified for tsn. Example: TSN=M.
LINK The link names used to open the files will be displayed. Standard: No link names will be displayed.
link Only those files opened with the specified link name will be displayed. For example: LINK=ECERDLOD selects all loaded programs.
USER=userid
Specifying a userid (e.g. TSOS), will result in only tasks running under that particular userid being checked for open files.
POOL=isam-pool
Specifying a Pool Name will result in all NK-ISAM files linked to this pool being selected.
D-IO [><=x]
The number of IO's that have occured within a specified time period (Standard=30 seconds) for each file will be displayed in the AGE column of the file list. In contrast to the D-IOS option (see below), files which have been opened by more than one task will be displayed once for each task, together with the TSN and associated number of IO's. Files can be selected which have used more than, less than or exactly x IO's by using the suffix ><=x . Example: OPENS D-IO>0
D-IOS [><=x]
The number of IO's that have occured within a specified time period (Standard=30 seconds) for each file will be displayed in the AGE column of the file list. The total number of IO's performed will be displayed for those files which have been opened by more than one task. The TSN column will contain the value '****' in this case, since the IO value does not relate to a particular task. Files can be selected which have used more than, less than or exactly x IO's by using the suffix ><=x .
Example:
User Option: OPENS,D-IOS>0 and Sort-Option: AGE,D
The open files will be sorted in ascending order of used IO's.
INT=sec
Length of the time period for D-IO in seconds. Standard: INT=30.
In order to calculate the IO values CFS will be placed in a wait state for the duration of the waiting period.
RW In the first two columns the number of Read and Write IO's used by each file will be displayed, instead of the usual LASTP and TYP values.
If no selection condition is specified, all files opened in input or output mode will be displayed. The following files will not be displayed:
- those opened by system tasks
- those opened in EXEC mode (loaded programs, SDF syntax files)
- those assigned with a File command, but not yet opened
Output from the OPEN User Option:
In the User Option column of the file list, the TSN of the task which opened the file, or that which issued a File command will be displayed.
*REM in the TSN column indicates that the file was opened from another host. The own host must be defined as the Master for the shared pubset.
The mode in which the file was opened will be displayed in this column:
I Input
O Output
IO Inout
OI Outin
U Update
E Extend
EX Exec
R Reverse
_ Inactive TFT entry. The file is not open.
S File is reserved with a SECURE command as shareable
SE File is reserved exclusively with a SECURE command
PR File is printed with PRINT ...,LOCK=YES
An asterisk (*) in front of the mode indicates that the file is cataloged as SHARUPD=YES .
With open NK-ISAM files, the name of the ISAM pool will be displayed in the first column of the file list (LASTP).
Examples:
OPEN O
All files opened for ouput at the time of selection.
OPEN TSN=9011
All existing TFT entries for TSN 9011 at the time of selection.
OPEN TSN=M,LINK
All files opened by the system task M, together with their respective link names.
OPEN IOEN,LINK=CFSCMD
All active or inactive TFT entries with the link name CFSCMD.
OPEN USER=S43
All files opened by tasks running under userid S43.
OPEN POOL=$TASK01
All NK-ISAM files associated with pool $TASK01.
Notes:
If no SORT OPTION is specified, the files selected by the OPEN User Option will be listed first in TSN sequence, and then in the order in which the FILE command was issued. A file can appear in the list more than once if it was opened by different tasks.
Selecting files with the OPEN User Option can be combined with other selection conditions, particulary in the FILENAME-SELECT field. For example, to find all tasks which have opened a particular file, enter the fully qualified file name followed by the ,Q parameter in the FILENAME-SELECT field, and OPEN in the User Option. For further information, see page 4-.
After selecting files with the OPEN User Option, the S Action Code can be entered to issue a Status Command for the respective TSN.
USER OPTION : OPEN may not be specified with USER-ID : (JOIN).
IO evaluation with the D-IO option: The KDCMON program cannot be executed for the duration of the evaluation. Conversely, the D-IO option cannot be invoked during a KDCMON measurement run. A D-IO evaluation can also not be used by more than one user at a time. In this case a "KDCMON active" message will be displayed. If this message appears even though the KDCMON program is not loaded, the lock situation can be resolved by using the X-IO option instead of D-IO.
A file list created with D-IO can be sorted with the CFS SORT D-IO,D or SORT AGE,D command. This will display the list in descending order of number of used IO's. The same sort order can be achieved by using the SORT OPTION field in the selection mask. The sort criterion AGE,D should be specified here.
The procedure FILEIO in the CFS.USERLIB.BEISPIEL can be called to monitor IO traffic for a particular file or task. (DO $user-id.CFS.USERLIB.BEISPIEL(FILEIO),? ).
The OPEN User Option can also be used by users other than TSOS. The open files that can be displayed will then be restricted to the current userid. The contents of SAM or PAM files opened in write mode can be displayed by entering the Action Code D (Display). In order to utilise this facility, the system administrator must start a CFS-Holdertask under $TSOS: /ENTER $CFS.CFS.S.LMSLIB(CFSHT). For further information, see the inline description in the enter file.
The file list format for the OPEN User Option is described on the following page.
File List Format for the OPEN User Option:
With a mouseclick you get a describtion of the screen item.
Select all active Monitor Job Variables
ONEVT All Monitor Job variables in the system which are currently being monitored by means of an ONEVT command or macro will be displayed. This User Option can only be run under TSOS and utilises the SVC 79. The ONEVT User Option can be made available in a restricted form for non-TSOS users if the system administrator starts a CFS Holdertask under TSOS (/ENTER CFS.S.LMSLIB(CFSHT) ).
Selection parameter: [,S] [,TSN=tsn]
S System tasks utilising Monitor Job variables will be checked in addition to user tasks.
TSN=tsn
Display all active Monitor Job variables for the specified TSN.
Output from the ONEVT User Option:
The TSN's of those tasks whose Job variables are being monitored with an ONEVT command will be displayed in the User Option column. If more than one task is monitoring a Job variable, the JV name will appear in the file list for each occurence.
Notes:
If no SORT OPTION is specified, the Job variables selected by the ONEVT User Option will be displayed in TSN order. A Job variable will appear in the list for each TSN which is monitoring it.
Selecting Job variables with the ONEVT User Option can be done in conjunction with any other condition, particularly FILENAME-SELECT.
After Job variables have been selected with the ONEVT User Option, the status of the tasks can be displayed by entering an S Action Code alongside the relevant TSN.
The OPN Action Code will display a list of all TSN's which are monitoring a particular Job variable.
USER OPTION : ONEVT may not be used in conjunction with USER-ID : (JOIN).
The ONEVT User Option is also available to non-TSOS users, but the display in this case will be restricted to the Monitor Job variables under that userid. In order for non-TSOS users to access this User Option, the system administrator must have started a CFS Holder task under TSOS: /ENTER $CFS.CFS.S.LMSLIB(CFSHT). For further information, see the description contained in this Enter file.
Examples:
ONEVT
All Job variables monitored by an ONEVT command across the whole system will be displayed.
ONEVT TSN=9011
All Monitor Job variables being monitored by TSN 9011.
Select all Files / Job Variables with a particular password
PSW This User Option will either display the WRITE, READ or EXEC password for the selected file / Job variable, or will select all files / Job variables protected by a specified WRITE, READ or EXEC password.
Obligatory parameter: W | R | E
The WRITE, READ, or EXEC passwords will be displayed.
Example:
PSW W
The Write passwords, if any, will be displayed for the files in the list.
Optional Selection parameter: [, X'passw'] | [, C'passw']
All files protected by the specified password will be selected.
Example:
PSW W,X'AFFE'
All files cataloged with the Write password X'AFFE' will be selected.
Note:
The PSW User Option is only applicable in BS2000 systems that have not implemented password encryption.
Display Space Utilisation by a File on a particular Volume
VOLSP The number of PAM pages utilised by the file on the specified disk (VSN) will be displayed.
Selection parameter (mandatory): vsn [ >x | <x | =x ]
>|<|=x is optional, and will select all files using more than, less than, or exactly x pages on the specified volume.
Variable Actions
Copy files between different userids or Public Volume Sets
ONXCOPY ':x:$userid1.'=':y:$userid2.' [, STD] [, KD]
This variant of the COPY Variable Action is only applicable if the files were selected by entering FSTAT $user-id1. in the FILENAME-SELECT field, or by setting the CFN option (see page 18-).
The Variable Action will result in all files marked with X being copied from $userid1. and PVS :x: to $userid2. and PVS :y:.
ONXCOPY '' = '$userid.' [, vsn/device | :x: ] [, STD] [, KD]
Th prerequisite for this Variable Action is that the user has selected files from a particular userid by specifying a value in the USER-ID field.
The files marked with X will be copied from the selected userid to $userid specified in the ONXCOPY statement. The files will thus retain their names across different userids.
vsn/device The copied files will be created on the specified private devices.
:x: The files will be copied to the specified Public Volume Set.
STD Note: When copying files under TSOS, CFS will issue all necessary passwords. The ACCESS=READ and RETPD>0 attributes of the files to be overwritten will also be temporarily reset by CFS for the purposes of the copy. The same is true for the ONXMOVE Variable Action.
The STD operand will cause the current protection attributes of the files not to be circumvented when performing the ONXCOPY Variable Action under TSOS. This means that only those files for which the user has issued a valid password will be copied. In addition, files will not be copied if the target file name already exists, or if they are cataloged as ACCESS=READ or RETPD>0.
KD Keep Date. When copying the file, the Creation Date of the original file will be transferred to the target file. The target file will thus have the same Creation Date as the original file, and not today's date, as normal. The KD option is not valid if files are copied to a private volume.
If KLA mode is activated (KLA command), the Last Access Date of the input and output file will be retained.
Examples: $ABC. = selected userid.
ONXCOPY''='$USER2.' $ABC.name --> $USER2.name
ONXCOPY':X:'=':Y:' :X:$ABC.name --> :Y:$ABC.name
ONXCOPY''='A.' $ABC.name --> $ABC.A.name
ONXCOPY''='' $ABC.name --> name (own userid)
ONXCOPY' '=.X' $ABC.name --> $ABC.name.X
Note:
The automatic circumvention of passwords is only possible in BS2000 systems without password encryption (ENCRYPT=NO).
ONXCOPY '$userid.' | ':x:'
The marked files will be overwritten by identically-named files from $userid. , or from the PVS :x:.
$userid. Userid of the source files.
:x: Public Volume Set of the source files.
Examples: selected files: PVS :R: own userid.
ONXCOPY':X:' :X:name --> :R:name
ONXCOPY'$USER2.' $USER2.name --> :R:name
Rename files from one userid to another userid
ONXREN ''='$user-id2.'
ONXREN '$user-id1.'='$user-id2.'
This Variable Action will cause all the files marked with X to be renamed from their current userid to a new userid, $user-id2. This can only be done between userids within the same PVS, because the data is not physically moved.
If the names of the files in the file list are displayed without the userid, then the Action should be entered using the general CFS name transformation rules (see page Seite 5-): ONXREN ''='$user-id2.'
If the names of the files in the file list do contain the userid ($user-id1.), then the Action should be entered as follows: ONXREN '$user-id1.'='$user-id2.'
Files on private volumes, or file generations cannot be renamed to another userid using the ONXREN Variable Action.
ONXLISTCAT outfil [, VERSION=0 | 2 | 3] [, E]
This Variable Action will create a variable length record in the file outfil for each file or Job variable marked with X. The record will be a 1 to 1 representation of the full catalog entry.
Any existing passwords will not be overwritten with binary zeroes.
VERSION=3 This parameter is only available to the system administrator under the TSOS userid. The physical catalog entry will be written to the output file. The layout is described by the DSECT DCACATE MF=D,CETYPE=*FILE | *JV.
A Listcat file created with VERSION=3 cannot be processed with the RECAT command.
The RECAT command (see page A1-) can be used in conjunction with an extract file created by the LISTCAT command. RECAT compares the entries in the LISTCAT file against the actual entries for the files, and will issue a CAT command in the event of any inequalities to reset the attributes to their previous values.
Reorganise Libraries / ISAM Files
ONXREORG ['str1'='str2'] [, :x: | vsn/device | PAD=nn | NR | SPACE=(xxxx,yyy) | KD ]
The marked libraries/ISAM files will be reorganised by copying all elements/records to a new library/file. For a full description of all of the REORG Variable Action parameters, see page 5-.
KD Keep Date. The reorganised files/libraries will retain the Creation Date of the original file, and not be stamped with todays date. The KD option is invalid if the files/libraries are reorganised on a private volume.
The KD option will also result in the Backup Version # and the Save Version # of the file being retained. This is important for the Archive status.
Move files to another Pubset and retain Creation Date.
:x: The files marked by the user with X will be moved to the specified Public Volume Set under the same name.
KD Keep Date. When moving to the new Pubset, the files will retain the original Creation Date value. The KD option is invalid if files are moved to a private volume.
If KLA mode is activated (KLA command), the Last Access Date of the input and output file will be retained.
Set Passwords for password-protected Files / Job Variables
ONXSETPSW This Variable Action will set all necessary passwords to allow unrestricted access to all the files or Job variables marked with X.
This Variable Action is only possible in BS2000 systems without password encryption (ENCRYPT=NO).
Unlock Files / Repair ISAM Files
ONXVERIFY [REP[AIR]=NO|YES|ABS|CHECK]
The files marked with X will be unlocked, i.e. any locks currently in force will be reset. Any ISAM files not correctly closed, perhaps as a result of a system crash, will be repaired to a consistent state (REPAIR=YES). The REPAIR parameter has the same meaning as its counterpart in the BS2000 VERIFY command.
The Variable Action ONXVERIFY provides the same functionality as the BS2000 VERIFY command, or REPAIR-DISK-FILES. The only difference is that the user is not asked before each file is unlocked. The Variable Action is also appropriate in batch mode.
Action Codes
Copy Files and Keep Creation Date
CKD Copy + Keep Date. When copying, the Creation Date of the original file will be transfered to the target file.
Display Contents of SAM/PAM Files opened in Output Mode
D If open files have been selected with the User Option OPEN [S] (see page A1-), the D Action Code can be used to display the contents of SAM or PAM files (e.g. SYSOUT / SYSLST files, CONSLOG files).
Notes:
The D Action Code works by transferring the current contents of the open file to a temporary file, which is then displayed by CFS. D thus provides an easy way of updating this temporary file. The command sequence D;++ will position the display at the end of the SAM file.
Usually, the contents of an ISAM file opened in write mode cannot be displayed, or only if it is opened as SHARUPD=YES. A special option can nevertheless be used to display the contents of an ISAM file in PAM format. This is done by executing the following CFS command once before issuing the D Action Code: M L'29AD','X'
For SAM/PAM files opened in Output mode, the value in the LASTP column of the file list will contain the number of occupied PAM pages at the time the selection took place.
When using the D Action Code on a file with a LASTP value greater than 200, the transfer of the PAM blocks already created to the temporary file can take some time. The user will therefore be asked if the display is to be of the entire file, or only of the last n PAM blocks. Choosing a small value for n will ensure a negligible delay in transferring the PAM blocks to the temporary file.
The D Action Code can also be used by non-privileged users to diplay the contents of open SAM/PAM files. In order to use this option, the system administrator must have started a CFS-Holder task from under TSOS: /ENTER $CFS.CFS.S.LMSLIB(CFSHT). For further information, see the inline description within this Enter file.
Ignore the Protection Attributes when deleting Files / Job Variables
EI ERASE... ,IGNORE=(ACCESS,EXDATE,RDPASS,WRPASS)
When deleting objects, the attributes ACCESS=READ, RETPD>0, the Basic Access Control List as well as any existing Read and Write passwords are ignored.
Display Passwords for File / Job Variable
FP for files: FSTAT file,P
for Job variables: STAJV jobvar,P
Any existing passwords will be displayed. This variant of the F Action Code is only permitted under TSOS.
Display all task that have opened a file
OPN The TSN's of all tasks which have opened the file marked with the Action Code (User Option OPEN) will be displayed.
If the file is a SAM file, opened in Output mode, the current contents of the file can be displayed with the D (Display) Action Code after the OPN has been issued.
Issue Passwords for Password-protected Files / Job Variables
SP A PASSWORD command to allow unrestricted access to the file or Job variable marked with this Action Code will be issued.
The SP Action Code is only applicable in BS2000 systems without password encryption (ENCRYPT=NO).
SPREL The files, PLAM library elements or job variables marked with this Action Code will have any password associated by SP released from the password table (PASSWORD ...,REL=Y).
Display the Number of Unused Data Blocks for ISAM Files
SFI A BS2000 command /SHOW-FREE-ISAM-SPACE will be issued for the specified ISAM file.
This Action Code can only be executed under the TSOS userid. Additionally, the FSC software product SPACEOPT V2.0 or higher must be installed.
Commands
File Transfer under TSOS (FT/ONXFT)
FT If CFS is loaded from the TSOS userid, the following points should be noted when using the CFS command FT, or the ONXFT Variable Action: If files are transferred which do not reside under TSOS, and if *SAME was entered in the "Filename in Target System" field, then the files will be transferred to the original userid, and not to TSOS. This is true for files being transferred to a remote system, as well as from it.
Display BS2000 Volume (Public/Private Volume) in Display Mode
I vsn/device CFS allows an entire disk drive to be viewed in Display Mode, in a similar fashion as the DPAGE utility. A command in the form I vsn/device should be issued to create an entry in the file list for the required volume. A D (Display) or M (Modify) Action Code can then be entered for this volume.
JES [params] The JES system for administering Join entries will be activated.
Specifying any optional parameters will select Join entries. This selection will be presented to the user as a Join list. If no parameters are specified, the JES Selection mask will be displayed.
JES is fully described in the "JES User Manual".
Examples:
JES
JES is invoked, and the user is presented with a mask in which the selection criteria for the Join entries can be entered. If the user had called JES previously, and exited with the command CFS, calling JES again will reactivate it at the point from which it was exited.
JES;
JES is invoked, and a list of all Join entries of all Pubsets currently available will be displayed. Entering ';' as a parameter simulates transmitting an empty selection mask.
JES TSOS,Q
JES is invoked. TSOS,Q represents a selection parameter which will be executed immediately. The user will be presented with a list of the TSOS entries for all Pubsets.
Join Entry Services Group (JESG)
JESG [params] The JESG system for User Group Administration is invoked.
Specifying any optional parameters will select Group entries. This selection will be presented to the user as a Group list. If no parameters are specified, the JESG Selection mask will be displayed.
JESG is fully described in the "JESG User Manual".
Examples:
JESG
JESG is called, the user is presented with a selection mask with which a list of Group entries can be created. If the user had called JES previously, and exited with the command CFS, calling JES again will reactivate it at the point from which it was exited.
JESG;
JESG is called, and a list of all the Join entries of all the Groups will be displayed. Entering ';' as a parameter simulates transmitting an empty selection mask.
MRS All entries from a MRS catalog will be displayed in a mask.
The VOL Action Code will display all volumes belonging to a PVS or Volume Set in another mask.
The FREE Action Code will display all unused blocks (extents) on a pubset or volume, sorted in ascending size order (FREE Extent list).
The FIL Action Code can be used in the FREE Extent list to assign one or more free extents to a dummy file.
For a full description of MRS administration, see the TAS (Task Services) User Manual.
Display the Public Space Utilisation (PUBSP)
PUBSP [pubset] [, FILE=file] [, SUM | SAT | CAT]
A screen will be displayed in which the space utilisation of all, or of specific Pubsets is presented.
pubset The space utilisation of the specified Pubset is displayed. The Pubset identifier must be specified without the colons, e.g. A or TEST.
file The space utilisation table will be saved to a file with the specified name. The screen display in this case will be suppressed.
SUM Only the summary line (see below) will be displayed for each Public Volume Set.
SAT Only the summary line (see below) will be displayed for each Public Volume Set. A column titled PagesNextSat will be displayed instead of the #Files column. The values in this column reflect, for each pubset, the number of pages free till the next saturation level is reached.
CAT The format of the output list will be modified in so far as the columns #Files, Device, MN will be replaced with the number of used and free catalog blocks (4K blocks). The system administrator can use this option to get an overview of space utilisation and potential catalog bottlenecks on individual pubsets.
The PUBSP mask has the following format:
With a mouseclick you get a describtion of the screen item.
The following commands can be specified in the command field of the PUBSP mask:
/cmd any BS2000 command
+ | +n | ++ Position within the list
- | -n | -- Position within the list
HC file | NHC Set/reset hardcopy mode
PUBSP [pubset] another PUBSP command for an additional Pubset
NP* Update the current Pubspace list
LST Leave the PUBSP screen and return to the CFS file list, or to JES. (same effect as pressing K1; see below)
F3 Save the current mask to the standard Hardcopy file
K1 Leave the PUBSP screen and return to the CFS file list
Display Private Disk Space Utilisation (PRIVSP)
A mask will be displayed indicating the space utilisation of all private disks currently online. If the PRIVSP function is to be made available to users other than TSOS, the system administrator must have started a TASHT Holdertask from under TSOS (/ENTER CFS. S.LMSLIB(TASHT) ).
priv The space utilisation of the private volumes whose VSNs are partially qualified will be displayed. Example: PRIVSP PVT.
file The space utilisation table will be written to a file with the specified name. In this case, the screen output will be suppressed.
The following commands can be specified in the command field of the PUBSP mask:
/cmd any BS2000 command
+ | +n | ++ Position within the list
- | -n | -- Position within the list
HC file | NHC Set/reset hardcopy mode
PRIVSP [priv] another PUBSP command for an additional Pubset
NP* Update the current Pubspace list
LST Leave the PUBSP screen and return to the CFS file list, or to JES. (same effect as pressing K1; see below)
F3 Save the current mask to the standard Hardcopy file
K1 Leave the PUBSP screen and return to the CFS file list
Recreate File Attributes and Passwords
RECAT file [, CATID=pvs] [, UID=user-id] [, CJ] [, IMP] [, NC] [, NU] [, P] [, KD]
The RECAT command can be used in conjunction with a catalog extract created with an ONX LISTCAT file Variable Action. The following checks are made for each catalog entry in the Listcat file:
a) does the file exist?
b) if yes: Do the current attributes, such as SHARE=YES, ACCESS=WRITE match those from the catalog extract. If not, a /CATALOG command will be issued to reset the attributes to their original values.
The following file attributes are checked and reset if necessary:
- SHARE=YES
- ACCESS=READ
- RETPD
- AUDIT
- BACKUP-Level
- LARGE=YES
- DESTROY=YES
- BASIC-ACL
The following Job variable attributes are checked and reset if necessary:
- SHARE=YES
- ACCESS=READ
- RETPD
- BASIC-ACL
CATID=pvs The files/Job variables to be processed will be sought on the specified pubset. This is not dependent on the catid of the data object in the Listcat file.
pvs must be specified without the delimiting colons, e.g. CATID=TEST
UID=user-id The files/Job variables to be processed will be sought under the specified userid. This is not dependent on the userid of the data object in the Listcat file.
user-id must be specified without the delimiting $ sign and full stop, e.g. UID=TT08
The non-privileged CJ, IMP, NC and NU parameters for the RECAT command are described in the CFS User Manual on page 7-.
KD Keep Date. The Creation and Modify dates associated with the file in the Listcat file will be restored. The KD option is not applicable for Job variables, or for files stored on private volumes.
P If the P option (RECAT file,P) is specified, Passwords (READ/WRITE/EXEC)will also be recreated if they no longer exist, or the contents no longer match.
Notes:
The P option can only be specified if CFS was loaded from TSOS. The catalog extract file must also have been created under TSOS. (ONXLISTCAT file).
The P option can only be used in BS2000 systems that do not have password encryption (ENCRYPT=NO).
The RECAT function can also be called directly from CFSLIB: /EXEC (RECAT,CFSLIB). The operands necessary as parameters, file [,P] will in this case be requested from SYSDTA (RDATA macro).
Reorganise Libraries / ISAM Files
REORG lib1 [, lib2] [, :x: | vsn/device | PAD=nn | NR | SPACE=(xxxx,yyy) | KD ]
The specified library/ISAM file will be reorganised, in so far as all elements/records will be transferred to a new library/ISAM file For a full description of the REORG command, see page 7-.
KD Keep Date. The reorganised file/library will contain the same Creation Date as the original file, and not that of today, which would be the case if the KD option were not specified. The KD option is invalid if the reorganisation takes place to a private disk.
TAS [params] The Task Services (TAS) will be called. Specifying optional parameters will control the selection of tasks. A task list will be presented as the result of the selection process. If no parameters are specified, the user will be presented with the task selection mask.
The TAS program is described fully in the "TAS User Manual".
Examples:
TAS;
TAS will be called, and the list of all active tasks displayed immediately. The semicolon simulates transmitting an empty selection mask.
TAS TSOS
TAS will be called. The string TSOS will be inserted into the first field of the selection mask (the USER-ID field), and the selection made on this basis. The result will be a list of all tasks logged under TSOS.
TASNO;DSSM
TAS will be called, and no selection made. In the "COMMAND" field of the empty task list, the command DSSM will be executed. As a result, all subsystems, together with their status, that are contained within the subsystem catalog will be displayed.
Import MVS PO Libraries to LMS Libraries (MVSIMP)
(MVSIMP) The (MVSIMP) command can be used to transfer PO (partitioned organized) libraries from the IBM MVS operating system to LMS libraries under BS2000. The contents of the PO libraries must have been exported to tape from MVS by means of the IEBUPDTE utility program (PUNCH statement).
The tape must be created under MVS with RECFORM=FB, BLKSIZE=2000 and RECSIZE=80.
The file must be cataloged in BS2000 as follows:
/FILE file,LINK=MVSIMP,VOLUME=...,DEVICE=..., STATE=FOREIGN
The (MVSIMP) command will transfer any existing library elements on the tape to an LMS library with the fixed name of LMS.MVSIMPORT. If a library with this name does not yet exist, the user will be asked which type of library, FMS, LMS, or PLAM, should be created.
Note: CFS also offers a TRANSF function for transferring files from BS2000 to MVS via tape. The TRANSF program is described in a separate document.
Open/Close User Exit for Display and Modify Command
The system administrator can prevent or control access to sensitive files by means of their own routines using the Open/Close Exit.
An example is to use the CLose Exit to reset the Last Access Date to the original value following a read access operation on a file (Display/ ONXFIND/User Option FIND).
(KLA) The Keep Last Access Mode is activated with the (KLA) command, and deactivated with the (KLA)OFF command.
Calling Conventions and Parameter Lists
The addresses of the Open/Close Exits should be entered in the YOPENAD/YCLOSEAD fields of the Global area (DSECT GLOBAL macro) (e.g. using CFSMAIN).
The Open and Close Exits will be called by CFS before and after processing the OPEN/CLOSE DVS macro call.
Register assignment / Parameters:
R1 Opcode.
X'00000001': Exit Call before executing the DVS macro.
Close Exit: Register R0 will contain the address of the FCB still open.
X'00000002': Exit Call after executing the DVS macro.
Open Exit: Register R0 will contain the adress of the opened FCB.
R13 Address of an 18 word Save Area.
R14 Return address in CFS.
R15 Start address: Start of the Exit.
Return information:
Return information in Register 15 will be evaluated following the return from an Open Exit with Opcode X'00000001'.
R15 = X'00000000': DVS Open Call may be executed.
R15 > X'00000000': DVS Open Call may not be executed.
CFS Holdertask, TSOS Services for non-privileged users
The CFS Holdertask can be started from TSOS by means of the Enter procedure J/CFSHT in the CFS.S.LMSLIB PLAM library. This Holdertask can be used to grant non-privileged CFS users access to certain services normally only available to TSOS. CFSHT provides the following services:
1) User Option OPEN for selecting open files.
The non-privileged user will be presented with a list of all files opened by tasks running under that userid. The user can also use the D-IO parameter to display the IO statistics for the open files under his userid.
The Holdertask will ignore parameter entries from the user requesting access to files for which no permissions exists, for example, files under a foreign userid.
2) Action Code OPN. All TSN's which have opened the file marked with this Action Code will be displayed. TSN's from userids other than the current userid will also be displayed. The Action Code S (STA tsn) can also be used to display status information about the task. Issuing an S Action Code for tasks running under userids other than the current userid can be pevented by setting an option in the CFSMAIN module.
3) Action Code D (Display) for viewing the contents of an open output file. This function is only possible for files previously selected by means of the OPEN User Option.
The CFS Holdertask creates a snapshot file with the current contents of the open SAM/PAM file. This file will be created under the current userid. CFS will delete the file after the Display function has been terminated.
4) :cmd in the Command field of the file list. The non-priveleged user can thus issue commands from under the TSOS userid. The command output (SYSOUT) will be returned to the user. The SYSOUT file of the Holdertask will also contain a listing of all the commands issued, together with the TSN and userid of the requestor.
The following sections describe the options available to the system administrator for enabling specific BS2000 commands for specific users (userids).
In order to enable any of the commands for non-privileged users, a control file must be linked with the CFS Holdertask using the lnkname CFSHTCMD, e.g. FILE CFS.HTCMD,LINK=CFSHTCMD. The standard SAM file CFS.HTCMD contains sample commands and userid information. It also contains extensive commentary lines, indicated by an asterisk in the first column (though not *ALL statements).
The CFS.HTCMD file can be modified in the current session, with the modifications becoming effective immediately.
Example:
STAJV
SETJV
$TEST
SHOW-DAB
VERIFY
JOIN TEST,PASS=
ENTER $TEST.CFS.E.BATCH
$TESTUTM
START-SS 'UTM','AIDSYS'
$SYSPRIV
*ALL
The SHOW-DAB, VERIFY, ENTER $TEST.CFS.E.BATCH commands are reserved for those under the $TEST userid.
The START-SS command with parameters UTM and AID may only be executed from the $TESTUTM userid.
All BS2000 commands may be executed with :cmd from the SYSPRIV userid. The VERIFY and REPAIR-DISK-FILE commands, which normally require confirmation from the user, will be executed automatically by the CFS Holdertask.
All other userids, i.e. those other than $TEST, $TESTUTM and $SYSPRIV are permitted to execute STAJV and SETJV. These commands have no $userid prefix.
Specific commands allowed for users:
The commands must be entered by the user in the CFS command field in the form :cmd [param] .
The CFS.HTCMD file contains sample entries in the form xxx [yyyyy]
CFSHT will check whether the user has a sample command xxx which matches the specified cmd. If no match is found, the user will receive the message "CFSHT: Command not allowed for user", and the command will not be executed.
If only the command name is specified in the sample, the user may execute that command with any parameters. The command must be entered exactly as it appears in the sample. Abbreviations, even though permitted by SDF, will be refused.
Command parameters in the sample entries:
If parameters are specified alongside the command name, then these will be checked specifically by the CFSHT. These parameters will be treated as CFS search strings if they begin with ' , -' , or ( . If this is not the case, the string will be matched via a simple CLC loop with the parameter entered by the user.
Complex search conditions such as AND, OR, Wildcard, as well as negations, can be specified for CFS search conditions. A disadvantage is that quotes must be specified twice.
Only one string can be specified with a simple search condition. A search will then be made for the string exactly as it appears in the HTCMD file. No duplication of quotes is necessary in this case.
Example 1:
JOIN TEST,PASS=C'A
The parameter of the JOIN command will be examined for the string TEST, PASS=C'A'.
Example 2:
JOIN ('TEST','UTM')*'PASS=C''A'
The parameter of the JOIN command will be examined for the string TEST or UTM, and for PASS=C'A after that.
Allow users access to all commands, with a few restrictions:
The CFS.HTCMD file will contain sample entries in the form -xxx
CFSHT will check if a sample entry xxx exists for the user which corresponds to the specified command cmd. If so, the command will not be executed, and the user will be presented with the message "CFSHT: Command not allowed for user". All other commands may be executed.