TRACKING EPILOG indicates the location of the tracking epilog, which is given to the Job Scheduler by the user.. TRACKING PROLOG indicates the location of the tracking prolog, which is g
Trang 1142 WHJOB Chapter 3
STATUS represents a 12-character string that indicates the status of the job Valid values
are a blank, SCHEDULED, RUNNING, COMPLETE, or N/A if not available This
read-only property is set by job tracking code and job scheduling code
STEP SOURCE CODE specifies an SCL list of general identifying information about the source code of the individual step in the process This source code is the same as is seen when selecting
View Code Process
in the SAS/Warehouse Administrator Process Editor
The source code information that is returned here will be that of a temporary working location of a copy of the source code and therefore might be different for each request for this information
SYSIN indicates the location of the job sysin file This property is a WHJOBFIL object This read-only property is set by job tracking code and job scheduling code
TRACKING enables or disables code generation for tracking prologs and epilogs Values are
-1— default to server definition
0— disable
1— enable
The default value for this property is -1 (default to server definition).
TRACKING EPILOG indicates the location of the tracking epilog, which is given to the Job Scheduler by the user This property returns a WHJOBCAT object The tracking epilog is appended to the input source code in order to update the job information file with the job completion information
TRACKING PROLOG indicates the location of the tracking prolog, which is given to the Job Scheduler
by the user This property returns a WHJOBCAT object
USER EPILOG indicates the location of the user epilog, which is given to the Job Scheduler by the user This property returns a WHJOBCAT object
USERPE enables or disables code generation for user prologs and epilogs Values are:
0— disable
1— enable
The default value for this property is 0 (disable).
USER PROLOG indicates the location of the user prolog, which is given to the Job Scheduler by the user This property returns a WHJOBCAT object
Property Dependencies
If the JOB TYPE property is blank, then SCHEDULED START DATE is ignored If the JOB TYPE is non-blank, then a valid SCHEDULED START DATE is required
Trang 2SAS/Warehouse Administrator Metadata Types WHJOBCAT 143
Using WHJOB
WHJOB is an independent type To understand how jobs relate to other types, see the diagram on the foldout in Appendix 2
WHJOBCAT
Metadata type for scheduler catalog source file entries
Category: Text File Types
Parent
“WHSRCCAT” on page 236
Overview
The WHJOBCAT type models the metadata for SAS catalog entries that are defined for jobs, such as entries for user-supplied source code, tracking options, and user-defined prologs and epilogs
Properties
The following table lists all the properties for WHJOBCAT and indicates how you can use each property with metadata API methods
In the table, you can specify properties with a Yes in the Indirect Add column when
you indirectly add one object through another, as described in the documentation for the _UPDATE_METADATA_ method Use this approach to add a new dependent object For details, see “Using _UPDATE_METADATA_” on page 46
You can pass properties with a Yes in the Update column to the
_UPDATE_METADATA_ method, as described in the documentation for this method Use this method to update properties of an existing object For details, see “Using _UPDATE_METADATA_” on page 46
* Req indicates that the property is required; you must provide a value for this
property when you use a given method * Default indicates that the system will provide
a default value for that property if you do not provide one * Auto supplied means that
the property is automatically supplied; any value that you specify for such a property is ignored
Properties with a Yes in the Read Method Expand Parm column are valid with the
expand parameter of the _GET_METADATA_ method This method enables you to get
detailed metadata about a property and its associated objects through a single method call
Trang 3144 WHJOBCAT Chapter 3
Expand Parm.
Extended Attributes
supplied
New properties for WHJOBCAT are as follows:
JOB ROLE indicates the role that this object serves for the job The possible values are
TRACKING PROLOG, TRACKING EPILOG, USER PROLOG, and USER EPILOG.
RESPONSIBILITY specifies the character string that indicates who is currently responsible for the
creation of the code that is associated with this process Possible values are SAS or USER.
SASindicates that SAS/Warehouse Administrator is creating this code
dynamically, based on the current metadata USER indicates that the user has
written the code for this process and is responsible for it
Using WHJOBCAT
WHJOBCAT is a dependent type, like all subtypes of WHSRCCAT To understand how all subtypes of WHSRCCAT relate to other types, see the process model in
“Relationships Among Metadata Types” on page 53
Use of _DELETE_METADATA for this type deletes SAS/Warehouse Administrator metadata, not the corresponding catalog entries
Trang 4SAS/Warehouse Administrator Metadata Types WHJOBFIL 145
WHJOBFIL
Metadata type for scheduler external file entries
Category: Text File Types
Parent
“WHTXTFIL” on page 269
Overview
The WHJOBFIL type models the metadata for all external file entries that are described to the Job Scheduler utility Properties for this type are set when you schedule a job through SAS/Warehouse Administrator
Properties
The following table lists all of the properties for WHJOBFIL and indicates how you can use each property with metadata API methods
In the table, you can pass properties with a Yes in the Add column to the
_ADD_METADATA_ method Use this method to add a new object
You can pass properties with a Yes in the Update column to the
_UPDATE_METADATA_ method Use this method to update properties of an existing object
* Req indicates that the property is required; you must provide a value for this
property when you use a given method * Default indicates that the system will provide
a default value for that property if you do not provide one
Properties with a Yes in the Read Method Expand Parm column are valid with the
expand parameter of the _GET_METADATA_ method This method enables you to get
detailed metadata about a property and its associated objects through a single method call
Expand Parm.
Extended Attributes
Trang 5146 WHLDETL Chapter 3
WHJOBFIL has the following new properties:
JOB ROLE
specifies the role this object serves for the job The possible values are LOG, LIST, SYSIN, or SOURCE.
REMOTE indicates a Boolean that states whether the object is remote to the metadata:
1=Remote, 0=Local.
Using WHJOBFIL
WHJOBFIL is a dependent type, like all subtypes of WHTXTFIL To understand how all subtypes of WHTXTFIL relate to other types, see the process model in
“Relationships Among Metadata Types” on page 53
WHLDETL
Metadata type for detail logical tables
Category: Object Types—Explorer
Parent
“WHTABLE” on page 254
Overview
WHLDETL models the metadata for detail logical tables in SAS/Warehouse
Administrator A detail logical table is a multipurpose table that you can use as a detail
table, a grouping element for detail tables, or a view on multiple that is related detail tables If you use it as a grouping element, a detail logical table defines columns that are shared by all of its detail tables
To add a detail logical table with the SAS/Warehouse Administrator Explorer:
1 Find a subject that does not already have a detail logical table (each subject can only have one)
2 Select the subject with the right mouse button
3 Select Add Item Detail Logical Table