Add Directory Shadow System (ADDDIRSHD)

The Add Directory Shadow System (ADDDIRSHD) command adds a supplier system to supply system distribution directory data to your system through directory shadowing.

Restriction: To use this command, you must have security administrator (*SECADM) authority.

Parameters

System name (SYSNAME)

Specifies a maximum of 8 characters for the name of the supplier system you are adding. You can specify uppercase letters A through Z, numbers 0 through 9, and special characters @, #, $, and embedded blanks. Embedded blanks must be enclosed in single quotation marks ('). Leading blanks are not allowed. The @, #, and $ characters are not recommended because they are not part of an invariant character set and are not available on all keyboards.

This is a required parameter.

Scheduled shadow (SCD)

Specifies the date and time at which the system you are adding begins supplying data to your system.

*CURRENT

The system begins shadowing data at the current date and time.

The possible Shadow Date values are:

scheduled-shadow-date

Specify the date on which the system begins supplying data to your system. The date must be specified in the job date format.

The possible Shadow Time values are:

scheduled-shadow-time

Specify the time at which the system begins supplying data to your system.

The time is specified in 24-hour format with or without a time separator as follows:

• With a time separator, specify a string of 5 or 8 digits where the time separator separates the hours, minutes, and seconds. If this command is entered from the command line, the string must be enclosed in apostrophes. If a time separator other than the separator specified for your job is used, this command fails.
• Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where hh = hours, mm = minutes, and ss = seconds. Valid values for hh range from 00 through 23. Valid values for mm and ss range from 00 through 59.

This is a required parameter.

Shadowing frequency (FRQ)

Specifies the frequency with which the supplier system you are adding shadows data to your system, based on the value specified on the SCD parameter.

*WEEKLY

Shadowing occurs once a week.

*DAILY

Shadowing occurs once a day.

*BIWEEKLY

Shadowing occurs every other week.

*MONTHLY

Shadowing occurs on the same date every month.

*MONTHLYREL

Shadowing occurs on the same relative day of the same relative week of every month, such as the first Monday of the month.

*HOURS

Shadowing occurs in the interval specified on the HOURS parameter.

Intervals of hours (HOURS)

Specifies the number of hours between shadows from the supplier system. This parameter is valid only when FRQ(*HOURS) is specified.

Days to skip (SKIPDAY)

Specifies the days of the week when shadowing does not occur. A maximum of five values, other than *NONE, can be specified.

This parameter is valid only when FRQ(*DAILY) is specified.

*NONE

No days are skipped.

*SUN

Sundays are skipped.

*MON

Mondays are skipped.

*TUE

Tuesdays are skipped.

*WED

Wednesdays are skipped.

*THU

Thursdays are skipped.

*FRI

Fridays are skipped.

*SAT

Saturdays are skipped.

Week of the month (MONTHWK)

Specifies whether shadowing that occurs on the same relative day of the month is scheduled to occur in the fourth week or the last week of the month.

This parameter is valid only when FRQ(*MONTHLYREL) is specified and when the SCD parameter date is the 22nd, 23rd, or 24th.

4

Shadowing occurs on the same relative day in the fourth week of the month.

*LAST

Shadowing occurs on the same relative day in the last week of the month, whether or not the month has four or five weeks.

Initial shadow (INZ)

Specifies the method used for the first shadow from the supplier system. The first shadow duplicates all of the local and shadowed data in the supplier system's distribution directory. Remote users are optionally supplied when the supplier specifies RMTSHD(*YES) on the Change Directory Attributes (CHGDIRA) command. Subsequent shadows include only data that has changed since the previous shadow.

The possible Automatic Shadow values are:

*APPC

The first shadow occurs when this command is run using advanced program-to-program (APPC) communication. If you are adding a supplier system with a large directory, you may want to specify *NONAPPC to prevent the first shadow from tying up your communications lines.

When *APPC is specified, Element 2 allows you to specify whether the data in the fields of a directory entry on your system is replaced by shadowed data if the same entry also exists in the supplier system's directory.

The possible Replace Data values are:

*NO

The data in the fields of existing directory entries on your system is not replaced with data from the supplier system.

*YES

All shadowed data is added to your system distribution directory. The data in the fields of existing directory entries on your system is replaced with shadowed data if the same entry also exists in the supplier system's directory.

*NONAPPC

The Copy to Directory (CPYTODIR) command is used for the first shadow. It is recommended that you run the CPYTODIR command before running this command. If shadowing from the supplier system you are adding starts before CPYTODIR is run, you may lose data.

*COMPLETED

The initial shadow has already been done using the CPYTODIR command.

Remote location name (RMTLOCNAME)

Specifies the remote location name of the supplier system you are adding.

*SYSNAME

The value specified on the SYSNAME parameter is used for the remote location name.

remote-location-name

Specify the name of a remote location.

A maximum of 8 characters can be specified. The first character must be an uppercase letter A through Z, or special character $, #, or @. The name cannot contain a blank, plus sign (+), period (.), or an underscore (_). For more information, see the APPC Programmer's Guide.

Mode (MODE)

Specifies the name of the mode that defines the sessions on the device used when shadowing data from the supplier system.

*NETATR

The mode in the network attributes is used.

mode-name

Specify the mode name.

A maximum of 8 characters can be specified. The first character must be an uppercase letter A through Z, or special character $, #, or @. The name cannot contain a blank, plus sign (+), period (.), or an underscore (_). For more information, see the APPC Programmer's Guide.

Remote network identifier (RMTNETID)

Specifies the supplier system's remote network identifier (ID).

*LOC

The remote network ID associated with the remote location is used. If several remote network IDs are associated with the remote location, the system determines which remote network ID is used.

*NETATR

The remote network identifier specified in the network attributes is used.

*NONE

No remote network identifier (ID) is used.

remote-network-ID

Specify a maximum of 8 characters for the remote network ID.

The first character must be an uppercase letter A through Z, or special character $, #, or @. The name cannot contain a blank, plus sign (+), period (.), or an underscore (_). For more information, see the APPC Programmer's Guide.

Local location name (LCLLOCNAME)

Specifies the local location name. The local location name is used to identify your system to the supplier system you are adding.

*LOC

The local location name associated with the remote location is used.

*NETATR

The LCLLOCNAME value specified in the system network attributes is used.

local-location-name

Specify a maximum of 8 characters for the local location name.

The first character must be an uppercase letter A through Z, or special character $, #, or @. The name cannot contain a blank, plus sign (+), period (.), or an underscore (_). For more information, see the APPC Programmer's Guide.

Text 'description' (TEXT)

Specifies the text that briefly describes the object.

*SYSNAME

The name specified on the SYSNAME parameter is used for the description.

'description'

Specify no more than 50 characters of text, enclosed in apostrophes.

Examples

Example 1: Shadowing a System Weekly

ADDDIRSHD   SYSNAME(NYCITY)
            SCD( '92/05/01' '17:00:00' )
            FRQ(*WEEKLY)  TEXT('Shadow New York System')

This command adds the supplier system NYCITY, which starts shadowing directory data to the local system on May 1, 1992 at 5:00 p.m. The shadow frequency is once a week. The description of the shadow system is 'Shadow New York System'.

Example 2: Shadowing a Remote System Hourly

ADDDIRSHD   SYSNAME(CHICAGO)
            SCD('92/04/01' '20:00:00')
            FRQ(*HOURS)  HOURS(12)  RMTLOCNAME(CHIC01)
            LCLLOCNAME(CHICAGO1)  TEXT('Shadow Chicago System')

This command adds the supplier system CHICAGO, which starts shadowing directory data to the local system on April 1, 1992 at 8:00 p.m. The frequency of shadows is every 12 hours. The description of the shadow system is 'Shadow Chicago System'. The remote location name of the CHICAGO system is CHIC01 and the local location name is CHICAGO1.

Error messages

*ESCAPE Messages

CPF90A8

*SECADM special authority required to do requested operation.

CPF90FE

Add or change of shadow supplier &1 was not successful.

CPF905C

Error occurred trying to find a translation table.

CPF9838

User profile storage limit exceeded.

CPF9845

Error occurred while opening file &1.

CPF9846

Error while processing file &1 in library &2.

CPF9847

Error occurred while closing file &1 in library &2.