Previous Topic

Next Topic

Book Contents

Book Index

Messages CTT500 through CTT5xx

This group includes messages for the Control-M/Tape product.

CTT501E PLEASE FILL IN TABLE NAME OR OMIT RULE

Explanation: A rule name was specified without a table name. A rule name cannot be specified without a table name.

Corrective Action: Either specify the table name, or omit the rule name, in order to receive a list of tables in the library.

CTT510E INVALID "ON". USE A, D, J, ME, MG, P, UC, US OR V

Explanation: An invalid option was specified in the ON field.

The ON field is used to specify criteria which must be met before Control-M/Tape performs actions. The option specified identifies certain criteria from the active environment.

Valid options in the ON field are:

Corrective Action: Correct the entry by specifying a valid ON option.

CTT511E VOLSER RANGE IS INVALID

Explanation: An invalid volser range was specified in ON VOLSER fields. The ON VOLSER field enables specifying a range of volsers. For a volser range to be valid, the first value in the specified range must be less than or equal to the second value.

Corrective Action: Correct the entry by specifying a valid range.

CTT512E VALID RETENTION TYPES ARE CA,CY,DAT,DAY,ED,J,L,P,R,M

Explanation: An invalid retention type was specified in a DO RETENTION statement. The DO RETENTION statement is used to specify a duration for which a data set or volser is kept. The retention type specified identifies how the duration is calculated. There may be a single retention type specified, or a combination of up to three different retention types using the AND/OR field.

Valid retention types are:

Corrective Action: Correct the entry by specifying a valid retention type.

CTT513E THERE MAY BE ONLY ONE RETENTION PERIOD PER "ON" BLOCK

Explanation: An attempt was made to open a DO RETENTION statement in a rule that already contains a DO RETENTION statement. The DO RETENTION statement specifies a duration for which a data set or volser is kept.

To avoid conflicting duration periods for the criteria defined in the ON block, there may be only one DO RETENTION statement per ON block.

Corrective Action: Instead of opening a second DO RETENTION statement, specify a combination of retention periods in one DO RETENTION statement using the AND/OR parameter.

CTT514E INVALID RETENTION COMBINATION

Explanation: An attempt was made to specify a retention period that does not correspond to previous retention periods in the DO RETENTION statement. The DO RETENTION statement has up to three different retention periods to specify a duration for which a data set or volser is kept.

To avoid conflicting duration periods, the combination of retention periods specified in one DO RETENTION statement must be logical. For example, a retention period of PERMANENT may not be combined with any other retention periods.

Corrective Action: Specify a valid retention combination.

CTT515E PERMANENT RETENTION IN VAULT. ADDITIONAL VAULTS CANNOT BE SPECIFIED

Explanation: An attempt was made to specify an additional vault or an additional retention period in a DO VAULT statement that already contains a retention period of PERMANENT. If a volume is to be kept permanently, it cannot be transferred to an additional vault, and no more retention periods can be specified.

Corrective Action: Clear the additional VAULT parameter or AND/OR parameter, if the volume is to be kept permanently, or change the retention period from PERMANENT to another retention period.

CTT516E RETENTION TYPE MUST BE FILLED IN

Explanation: A retention line was opened, but no retention type was specified. The retention period in a DO RETENTION, ABENDRET, or VAULT statement specifies a duration for which a data set or volser is kept. The retention type determines how the duration is calculated. There may be a single retention type, or a combination of up to three different retention types using the AND/OR field.

Valid retention types are: CA (MVS Catalog), CY (Cycles), DAT (Date), DAY (Days), ED (EDM), EX (EXPIRE), J (JCL EXPDT), L (Last access), P (Permanent), R (Return from vault), and V (VAULT DAYS). Some retention types are not valid for all retention periods in the different statements.

Corrective Action: Specify a valid retention type, or clear the preceding AND/OR field (or DO field in the case of a single retention) if no further retention criteria are required.

CTT517E VALID WHEN TYPES ARE A,CH,CL,K,M,O

Explanation: The WHEN type was specified in the WHEN field of a DO statement was invalid or absent. The WHEN parameter determines when the DO statement that contains the WHEN parameter is performed.

Valid WHEN types are:

Corrective Action: Correct the entry by specifying a valid WHEN type.

CTT518E ONLY ONE POOL NAME PER "ON" BLOCK MAY BE SPECIFIED

Explanation: An attempt was made to open a DO POOL statement in an ON block that already contains a DO POOL statement. The DO POOL statement specifies the pool from which a scratch volume is taken.

To avoid conflicting data when mounting a scratch tape, there may be only one DO POOL statement per ON block.

Corrective Action: Delete the second DO POOL statement by clearing the DO field.

CTT519E ONLY ONE PRINT LABEL OPTION PER "ON" BLOCK MAY BE SPECIFIED

Explanation: An attempt was made to open a DO LABEL statement in an ON block that already contains a DO LABEL statement. The DO LABEL statement specifies whether or not a label is to be printed when a data set is written on a volume.

To avoid conflicting data when deciding whether or not to print a label, there may be only one DO LABEL statement per ON block.

Corrective Action: Delete the second DO LABEL statement by clearing the DO field.

CTT520E ONLY ONE STACK OPTION PER "ON" BLOCK MAY BE SPECIFIED

Explanation: An attempt was made to open a DO STACK statement in an ON block that already contains a DO STACK statement. The DO STACK statement specifies whether or not stacking of data sets is performed on a certain volume.

To avoid conflicting data when deciding whether or not to stack data sets on a volume, there may be only one DO STACK statement per ON block.

Corrective Action: Delete the second DO STACK statement by clearing the DO field.

CTT521E ONLY ONE VAULT CYCLE PER "ON" BLOCK MAY BE SPECIFIED

Explanation: An attempt was made to open a DO VAULT statement in a rule that already contains a DO VAULT statement. The DO VAULT statement determines in which vaults, if any, a volume is to be kept.

To ensure that a volume is specified in the correct sequence of vaults, there may be only one DO VAULT statement per ON block. However, a sequence of vaults may be specified in a DO VAULT statement. An empty VAULT entry is opened whenever a new vault is specified in a DO VAULT statement.

Corrective Action: Instead of opening a second DO VAULT statement, specify a sequence of vaults in the DO VAULT statement using the empty VAULT entry at the end of the statement.

CTT522E A BLOCK WITH FILLED "DO" STATEMENTS AND NO "ON" STATEMENTS IS INVALID

Explanation: The rule does not contain any ON statements. Every rule must have at least one ON statement that identifies under what conditions to perform the DO statements.

The rule is not saved.

Corrective Action: Add an ON statement to the rule.

CTT523E AT LEAST ONE CYCLE MUST BE SPECIFIED

Explanation: In a DO RETENTION, ABENDRET, or VAULT statement, a value of zero was specified in the CYCLES field of a retention period. The CYCLES retention type determines the number of cycles that a volume or data set is to be kept. A cycle of a data set relates to the creation of a copy of the specified data set. A retention period of zero is invalid since it means there is no duration.

Corrective Action: Specify a valid number of CYCLES or change the retention type.

CTT524E ONLY ONE OWNER PER "ON" BLOCK MAY BE SPECIFIED

Explanation: An attempt was made to open a DO OWNER statement in an ON block that already contains a DO OWNER statement. The DO OWNER statement determines the owner of a volume data set. There may be only one owner for a volume or data set. Therefore, there may be only one DO OWNER statement per ON block.

Corrective Action: Delete the second DO OWNER statement by clearing the DO field.

CTT525E DATE ALREADY IN PREVIOUS VAULT RANGE

Explanation: A retention type of DATE was specified for a vault. However, the date specified overlaps the duration of the same volume in a previous vault.

The DO VAULT statement enables a volume to be kept in a sequence of vaults. Each vault may have its own retention period. A volume is transferred from one vault to the next vault in the sequence at the end of its duration field. Overlapping of dates is invalid. The calculated duration for the retention of a volume or data set in a vault must only begin at the end of the retention period of the previous vault.

Corrective Action: Modify the retention date to a date after the retention period of the previous vault.

CTT526E ONLY ONE "ON DATASET" STATEMENT PER RULE MAY BE SPECIFIED

Explanation: An attempt was made to add an ON DATASET statement in a rule that already contains an ON DATASET statement. The ON DATASET statement specifies the data set or data set prefix that must be matched for Control-M/Tape to perform actions defined in the rule. This is the basic search criterion. Therefore, only one ON DATASET statement is allowed.

Corrective Action: Delete one of the ON DATASET statements. A mask containing * and ? may be used instead of a data set name.

CTT527E VALID RETENTION TYPES ARE CA,CY,DAT,DAY,EX,J,L,P,V,M

Explanation: An invalid retention type was specified in a retention period of a DO VAULT statement. The DO VAULT retention period specifies a duration for which a data set or volser is kept in a vault. The retention type specified identifies how the duration is calculated. There may be a single retention type, or a combination of up to three types using the AND/OR field.

Valid retention types are:

Corrective Action: Correct the entry by specifying a valid retention type.

CTT528E VALID RETENTION TYPES ARE CA,CY,DAT,DAY,ED,J,L,P,M

Explanation: An invalid retention type was specified in a retention period of a DO ABENDRET statement. The DO ABENDRET retention period specifies a duration for which a data set or volser is kept in case of an abend. The retention type specified identifies how the duration is calculated. There may be a single retention type, or a combination of up to three types using the AND/OR field).

Valid retention types are:

Corrective Action: Correct the entry by specifying a valid retention type.

CTT529E INVALID DO STATEMENT WAS SPECIFIED

Explanation: An invalid DO statement was specified in a Control-M/Tape rule (screen TR). DO statements specify actions to be performed by Control-M/Tape when scheduling and selection criteria for a rule are satisfied. For more information about DO statements, see the description of ON and DO statements in the rule parameters chapter of the Control-M/Tape User Guide.

The rule definition cannot be saved.

Corrective Action: Either delete the invalid DO statement or replace it with a valid DO statement.

CTT530E POOL ASSIGNMENT IS INVALID AFTER "ON VOLUME" OR "ON MEDIA" ARE SPECIFIED

Explanation: A POOL assignment was requested by means of a DO field in a rule that previously contains ON VOLUME or ON MEDIA statements. The POOL assignment is only meaningful when scratch tapes may be requested. If a volume or media appears as criteria for executing the rule, scratch tapes cannot be requested.

Corrective Action: Correct the entry by deleting the POOL assignment.

CTT531E THE PREFIX FIELD ON CYCLE RETENTIONS MUST BE THE SAME

Explanation: An attempt was made to define a cycle retention type with a prefix that does not match the prefix of another cycle retention type. The prefix of the cycle retention types for the DO RETENTION and DO ABENDRET statements must be the same. The prefix of the cycle retention types within the DO VAULT statement must also be the same.

Corrective Action: Correct the entry.

CTT532E STACK=Y IS INVALID AFTER "ON {VOLUME | MEDIA | UCB} " IS SPECIFIED

Explanation: A STACK=Y statement was specified in a rule that previously contained an ON VOLUME, ON MEDIA, or ON UCB statement. STACK=Y processing takes place before media, volume or UCB information is available. Therefore, rules that are triggered by volume, media or UCB information cannot request dynamic stacking.

Correct the rule by deleting the STACK=Y statement or use a different ON statement.

Corrective Action: No action is required.

CTT533E UCB RANGE IS INVALID

Explanation: The UCB range specified in the TR screen is invalid. The FROM or TO value is not a valid UCB address (hexadecimal value) or the FROM value is larger than the TO value.

The rule cannot be saved until the range is specified correctly.

Corrective Action: Specify a valid UCB range and save the rule.

CTT534E ONLY ONE do_stmt STATEMENT PER RULE CAN BE SPECIFIED

Explanation: The specified DO statement (do_stmt) was included more than once in a Control-M/Tape rule. Only one DO statement of the specified type can be included in each Control-M/Tape rule.

The rule definition cannot be saved.

Corrective Action: Delete the duplicate DO statement, leaving only one DO statement of the specified type. See the section on ON and DO blocks in the chapter on rule parameters of the Control-M/Tape User Guide for more information about the specified DO statement.

CTT535E VALID SCOPES ARE DSN OR VOL

Explanation: An invalid value was specified for the SCOPE subparameter in a DO STACK statement in the Rule Definition screen (screen TR).

Valid SCOPE values:

The rule definition cannot be saved.

Corrective Action: Specify a valid SCOPE value.

CTT536E "DO STKRULE" IS VALID ONLY IF "DO STACK=Y"

Explanation: A DO STKRULE statement was specified in a Control-M/Tape rule that does not include a DO STACK=Y statement. A DO STKRULE statement can only be specified if a STACK=Y statement is specified earlier in the rule.

The rule definition cannot be saved.

Corrective Action: Either specify a DO STACK=Y statement earlier in the rule or remove the DO STKRULE statement.

CTT537E SPECIFY A JOBNAME, DSN, OR BOTH

Explanation: No value was specified for subparameters JOB and DSN in a DO STKRULE statement of a Control-M/Tape rule. The DO STKRULE statement describes data sets or jobs that create data sets, which should not be stacked with the data set whose access triggered the rule. Therefore, a value must be specified for at least one of these subparameters.

The rule definition is not saved.

Corrective Action: Specify the required jobname, data set name, or both, in DO STKRULE and save the rule.

CTT538E VALID OPTIONS FOR THIS FIELD ARE YES OR NO

Explanation: An invalid value was specified for the current field in a Control-M/Tape rule. This field must have a value of either YES or NO.

The rule definition cannot be saved.

Corrective Action: Specify either YES or NO and save the rule.

CTT539E VALID DYNVOL OPTIONS ARE I, E, N, P, OR Y

Explanation: An invalid value was specified in a DO DYNVOL statement of a Control-M/Tape rule.

Valid values for a DO DYNVOL statement are:

The rule definition cannot be saved.

Corrective Action: Either specify a valid value for the DO DYNVOL statement, or delete the statement.

CTT540E VALID RECREATE OPTIONS ARE YES, NO, OR PERMANENT

Explanation: An invalid value was specified in a DO RECREATE statement of a Control-M/Tape rule.

Valid values for a DO RECREATE statement are:

The rule definition cannot be saved.

Corrective Action: Either specify a valid value for the DO RECREATE statement or delete the statement.

CTT541E VALID STKMODE OPTIONS ARE SIMPLE, VAULT, RETENTION, OR ALL

Explanation: An invalid value was specified in a DO STKMODE statement of a Control-M/Tape rule. A DO STKMODE statement determines the algorithm used to search for a volume on which to stack the current data set. These searches are performed on the same pool as the eligible candidate volumes for stacking.

Valid values for a DO STKMODE statement are:

The rule definition cannot be saved.

Corrective Action: Specify a valid value for the DO STKMODE statement, or delete the statement.

CTT542E KEEP EVENT IS INVALID AFTER "ON PGM" IS SPECIFIED

Explanation: A DO statement at KEEP event was specified in a rule that previously contained an ON PGM statement. KEEP processing takes place when the PGM name is no longer available. Therefore, rules that are triggered by a PGM name cannot request an IOA service at a KEEP event.

Control-M/Tape does not save the rule definition.

Corrective Action: Correct the entry by deleting the KEEP event, or use a different ON statement.

CTT543E VALID FASTPOS OPTIONS ARE YES, NO, OVERRIDE, OR TEST

Explanation: An invalid fast positioning option was specified in a DO FASTPOS rule statement. The DO FASTPOS statement specifies the mode of operation for fast positioning.

Valid fast positioning options are:

Control-M/Tape does not save the rule definition.

Corrective Action: Correct the entry by specifying a valid fast positioning option.

CTT544E REDUNDANT RETENTION AFTER AN EMPTY AND/OR OPTION

Explanation: A value was specified in a RETENTION field but the AND/OR relationship to the value in a previous RETENTION field was left blank.

If values are specified in more than one RETENTION field, a value must be inserted into the AND/OR field relating to each of the RETENTION fields, except the last, to avoid inconsistency.

The definition is rejected.

Corrective Action: Correct the definition, either by deleting the current RETENTION value, or by inserting an AND/OR relationship between the current RETENTION and the previous RETENTION.

CTT545E STACK=Y ALONG WITH NONSPECIFIC VAULT RETENTION IS INVALID

Explanation: A Control-M/Tape rule definition is invalid. The definition included both of the following:

Dynamic stacking cannot be performed for data sets with an unpredictable return date from the vault. All stacked data sets on the volume must have the same return date from the vault.

The rule definition cannot be saved.

Corrective Action: Do one of the following:

CTT548E SEVERE ERROR IN CALENDAR OR YEAR NOT FOUND IN CALENDAR

Explanation: Either the year is not defined in the calendar, or the calendar was incorrectly modified.

The rule is not ordered.

Corrective Action: Check the contents of the rule order and the calendar. Correct accordingly, and reorder the rule.

CTT551E VALID CAPACITY TYPES ARE "S" (SLOT) OR "B" (BOX)

Explanation: An invalid capacity type was specified. Valid capacity types are slots and boxes.

Corrective Action: Specify a valid capacity type.

CTT552E PLEASE FILL IN TABLE NAME OR OMIT VAULT NAME

Explanation: A vault name was specified without a table name. A vault name cannot be specified without a table name.

Corrective Action: Either specify the table name or omit the vault name.

CTT553E THIS FIELD MUST BE NUMERIC AND GREATER THAN ZERO

Explanation: The field contains the value 0. It must hold a numeric value greater than 0.

Corrective Action: Correct the value in the field.

CTT554E A VALID CALCULATED BOX ID IS 2 - 6 CHARS LONG

Explanation: The combination of the box ID and Capacity parameters creates a calculated box ID that exceeds six characters.

Corrective Action: Change either the box ID or Capacity parameters, or both, so that their combination does not exceed six characters.

CTT555S INSUFFICIENT STORAGE. INCREASE THE REGION SIZE

Explanation: There was insufficient memory to perform a task.

The action that could not be performed accompanies this message. It may vary depending on the environment in which the message was issued.

Corrective Action: For jobs, increase the REGION size. For TSO, log on again using a larger SIZE parameter or exit one of the screens.

CTT556I CHANGE OF VAULT MAY CAUSE CHANGES IN CAPACITY TYPE BOX

Explanation: The vault name has been changed by the user from MAINLIB to a different name, and therefore all box definitions are automatically changed to box capacity definitions. Be aware that box definitions are allowed only under the definition of vault name MAINLIB.

Corrective Action: No action is required.

CTT557E DUPLICATE DEFINITION

Explanation: The same media capacity is already defined under the same vault, or the same box ID with the same media is already defined under the vault name MAINLIB.

Corrective Action: Do one of the following:

CTT567E USER NOT AUTHORIZED

Explanation: The function requested is not authorized for the user. The message is issued by the IOA security mechanism.

Corrective Action: Check with your system security administrator.

CTT567I COND cond ODATE odate {ADDED | DELETED | FOUND} BY USER userId / jobName (jobId)

Explanation: This information message indicates that the ADD, DELETE, or CHECK option completed successfully and the cond condition with the odate original scheduling date was added to or deleted from, or found in the IOA Conditions file.

In this message, odate is the date on which the message is issued. If the ADD, DELETE, or CHECK option is run by the IOACND utility in batch mode, the user ID (userId), job name (jobName), and job ID (jobId) of the batch file are also displayed.

Corrective Action: No action is required.

CTT570E VOLUME RANGE MUST BE DEFINED

Explanation: No volume range is defined.

Corrective Action: Specify the volume range.

CTT571E VOLUME RANGE IS INVALID

Explanation: Volume range is invalid. The first value in a valid volume range must be less than or equal to the second.

Corrective Action: Specify a valid range.

CTT572E PLEASE FILL IN TABLE NAME OR OMIT POOL NAME

Explanation: A pool name was specified without a table name. A pool name must have a table name.

Corrective Action: Either specify the table name or omit the pool name.

CTT585W A DSN=** STATEMENT IGNORED. RULE MUST BE DEFINED MANUALLY

Explanation: During the conversion of EPIC vaulting rules into Control-M/Tape rules, an EDM rule was found. EDM rules cannot be converted automatically. They must be defined manually.

The rule is not converted.

Corrective Action: Define the EDM rule manually by means of screen TR.

Parent Topic

CTT messages