| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
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.
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| SYSNAME | System name | Character value | Required, Positional 1 |
| SCD | Scheduled shadow | Single values: *CURRENT Other values: Element list |
Optional |
| Element 1: Date | Date | ||
| Element 2: Time | Time | ||
| FRQ | Shadowing frequency | *DAILY, *WEEKLY, *BIWEEKLY, *MONTHLY, *MONTHLYREL, *HOURS | Optional |
| HOURS | Intervals of hours | 1-999, 5 | Optional |
| SKIPDAY | Days to skip | Single values: *NONE Other values (up to 5 repetitions): *SUN, *MON, *TUE, *WED, *THU, *FRI, *SAT |
Optional |
| MONTHWK | Week of the month | 4, *LAST | Optional |
| INZ | Initial shadow | Single values: *NONAPPC, *COMPLETED Other values: Element list |
Optional |
| Element 1: Method | *APPC | ||
| Element 2: Replace data | *NO, *YES | ||
| RMTLOCNAME | Remote location name | Character value, *SYSNAME | Optional |
| MODE | Mode | Character value, *NETATR | Optional |
| RMTNETID | Remote network identifier | Character value, *LOC, *NETATR, *NONE | Optional |
| LCLLOCNAME | Local location name | Character value, *LOC, *NETATR | Optional |
| TEXT | Text 'description' | Character value, *SYSNAME | Optional |
| Top |
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.
| Top |
Specifies the date and time at which the system you are adding begins supplying data to your system.
The possible Shadow Date values are:
The possible Shadow Time values are:
The time is specified in 24-hour format with or without a time separator as follows:
This is a required parameter.
| Top |
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.
| Top |
Specifies the number of hours between shadows from the supplier system. This parameter is valid only when FRQ(*HOURS) is specified.
| Top |
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.
| Top |
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.
| Top |
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:
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:
| Top |
Specifies the remote location name of the supplier system you are adding.
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.
| Top |
Specifies the name of the mode that defines the sessions on the device used when shadowing data from the supplier system.
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.
| Top |
Specifies the supplier system's remote network identifier (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.
| Top |
Specifies the local location name. The local location name is used to identify your system to the supplier system you are adding.
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.
| Top |
Specifies the text that briefly describes the object.
| Top |
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.
| Top |
*ESCAPE Messages
| Top |