SACMIGR Selection Phase

- SACMIGR --------

- SELECT Filepool ( [ FILE----SACMIGR SELECT-------] ------------------[---------Select_fid-----------] ------------------[ SAFESFS--SAFESFS-------------] ------------------[---------Safesfsid------------] ------------------[ GROUP--------2---------------] ------------------[---------Target_Storage_Group ]

Purpose

SACMIGR SELECT is the second phase in the SafeAccess migration process. SACMIGR SELECT reads the SACMIGR MASTER and the SACMIGR SELECT files to decide which minidisk should be migrated to SFS. The list of minidisks to be migrated is written to the SACMIGR SELECTED A file. This file is later used as input to the SACMIGR MIGRATE phase. SACMIGR MASTER contains a list of all minidisk on the system. SACMIGR SELECT contains selection criteria specified by you. The selection criteria is used to select minidisks to be migrated from the list of all minidisks in the SACMIGR MASTER file. The selection criteria is defined using SELECT and FROM SELECTED records in the SACMIGR SELECT file. These records are described below.

Authorization

The userid that runs SACMIGR SELECT must have the SAFEACC 192 mdisk accessed.

Parameters

Filepool*

Specifies the name of the SFS filepool that will contain the data from the migrated minidisks after the completion of phase 3 of the migration process.

Options

FILE Select_fid	Indicates that the filename and filetype of the input file containing selection criteria records. The SACMIGR SELECT file is used if this option is omitted.
SAFESFS Safesfsid	Safesfsid is the userid of the SAFESFS service virtual machine. If omitted the default is SAFESFS.
Target_Storage_Group	Specifies the number of the SFS storage group that will contain the migrated minidisk data after completion of SACMIGR phase 3. If omitted, the default is storage group 2.

SAGMIGR SELECT File Selection Criteria Records

SELECT Keyword Operator Value	See table below for a description of KEYWORD, OPERATOR, VALUE specifications.
FROMSELECTED	Causes subsequent select records to be processed against ONLY records that were previously selected.

Keyword	Valid Operators	Value Type	Description
USER	= , <>	Character	Userid of minidisk owner.
DEVTYPE	= , <>	Character	Minidisk device type.
VOLSER	= , <>	Character	Minidisk volume serial number
LINKMODE	= , <>	Character	Minidisk linkmode
VADDR	= , <>	Character	Minidisk virtual address
RPASS	= , <>	Character	Minidisk read password
WPASS	= , <>	Character	Minidisk write password
MPASS	= , <>	Character	Minidisk Mult password
CMSSIZE	>,<,<>,>=,<=,=	Numeric	Total number of CMS formatted cylinders or blocks on minidisk
CMSBLKSIZE	>,<,<>,>=,<=,=	Numeric	CMS Blocksize of minidisk.
SPACEINUSE	>,<,<>,>=,<=,=	Numeric	Kilobytes of space used on minidisk.
FREE	>,<,<>,>=,<=,=	Numeric	Kilobytes of free space on minidisk.
NUMUSRSLINKING	>,<,<>,>=,<=,=	Numeric	Number of user that have linked the minidisk. (Requires SACDC in COLLECT phase.)
NUMFILES	>,<,<>,>=,<=,=	Numeric	Number of files on minidisk. (Requires SACDC in COLLECT phase.)

Return Codes

Return Code	Meaning
0	Processing completed successfully.
>0	Processing failed - see error messages produced for more information.

Usage Notes

1. SACDC data should only be used if the number of times a minidisk has been linked or the number of users that have linked the minidisk are to be used as criteria for selecting minidisks to be migrated. In most migrations, SACDC data is not used..



2. After running SACMIGR SELECT, browse the SACMIGR SELECTED file. This file contains the list of minidisks that will be migrated when SACMIGR MIGRATE is run. If this file contains minidisks that you do not wish to migrate, delete these records before running SACMIGR MIGRATE.



3. Trailing pattern matching may be used on SELECT records for all character values. Specify an asterisk "*" to match all trailing characters. Example: SELECT USER = HR*. This selects all minidisks owned by userids that start with HR.



4. FROMSELECTED records cause subsequent SELECT records to be processed against previously selected records only. This has an effect similar to an AND operator. More than one SELECT record without FROMSELECTED record in between is similar to using an OR operator.

1. SACMIGR SELECT FPOOL1



2. SACMIGR SELECT FPOOL2 (FILE SACMIGR2 SELECT SAFESFS SAFESF2 GROUP 3