the Workflow Design Panel is detailed in the next section.
8. On the last window in the Jobs Definition Wizard select check the Edit the Job definition after adding and click the Finish button to complete the Job.
Defining Symitar Job Commands Using the JAMS Workflow Designer Interface
After setting up the Job, the final step is to define the Symitar Job properties and commands.
As mentioned on the previous page, after clicking the Finish button with the edit checkbox activated, the Job Definitions window opens.
Choose the Source tab to access the Workflow Designer.
Note: this was the same interface displayed on Step 7 of the JAMS Job Definition Wizard.
The object-oriented workflow interface is made up of three panels. The left Toolbox panel contains a list of
“activities” that can be used as building blocks to customize a JAMS Job to most any specification.
These activities are organized into groupings (e.g., JAMS, SQL, Collection, Error Handling, etc.). In fact, there are 12 built-in Symitar (SYM) activities located under Toolbox’s SYM group. These activities can be used exclusively or incorporated into a workflow with other activities to create a Symitar Job.
Note: For a more detailed description of each SYM activity and their associated properties, go to the Descriptions Topic.
Preferred activities are dragged and dropped from the Toolbox on to the middle Designer panel.
Defining a Workflow Using a Sequence Activity
To get started, plan out the Job and then select the appropriate activity or activities from the Toolbox to include in the workflow. A key rule: workflow Jobs that contain more than one activity must be nested within a parent activity such as a Sequence or SymConfig activity.
Note: Sequences are the only activity that can contain multiple child activities. Other parent activities, such as SymConfig, can only comprise one child activity.
To incorporate additional activities into Job workflow, first drag a Sequence or SymConfig activity to the Designer panel and then drop other activities listed in the Toolbar panel into that object. This creates a parent-child activity relationship.
A Sequence is really just a container object that can help users create a more intricate workflow. This activity is located in the Control Flow group on the Toolbox panel. Just drag a Sequence object to the Designer Panel to set up the framework for the workflow.
Then insert the first activity from the Toolbox list into the Sequence object.
More complex Jobs can be designed using nested sequences to create complex branches with built in dependencies.
Using the Properties Panel
Select any activity from the Designer panel to view its specific properties. Use the Properties panel to populate or modify individual property fields for that object.
Please note any task messages appearing on the activity object. To view the message content simply hover the mouse over the object.
Note: All errors must be resolved before a JAMS Job can be successfully submitted.
Use the Save and Close button to complete the JAMS Symitar Job definition process.
JAMSUsername Any JAMS user.
LocalDirectory
The local directory is the download location for the SYM DataFile.
DisplayName
Use to modify the property name as displayed in the Designer panel.
Password
The AIX password. Use when overriding the value in the SymConfig Activity. As an alternative, if you wish to hide the password from viewing, (1) create a user in JAMS, (2) set the "Logon As" to the AIX Username, (3) click the password button and (4) enter the password for this account, and (5) then use that JAMS User Name in the JAMSUserName workflow property.
ServerFileName
The name of the DataFile on the SYM Server in the '/SYMnnn/DATAFILES' directory.
ServerName
The name of the AIX server. Use when overriding the value set in the SymConfig activity.
SymNumber
Use when overriding the value in the SymConfig activity. This parameter defaults to '000'.
UserName
The AIX UserName. Use when overriding the value in the SymConfig activity.
LetterFiletoPC
Downloads a LetterFile from the FTP Server to the PC. The LetterFile is downloaded from the SYMnnn/LetterSpecs directory, where nnn is a three-digit SYM Number (e.g., ‘007’).
JAMSUsername Any JAMS user.
LocalDirectory
Password
Use when overriding the value in the SymConfig Activity. As an alternative, if you wish to hide the password from viewing, (1) create a user in JAMS, (2) set the "Logon As" to the AIX Username, (3) click the password button and (4) enter the password for this account, and (5) then use that JAMS User Name in the JAMSUserName workflow property.
ServerFileName
The name of the LetterFile on SYM Server in the '/SYMnnn/LetterSpecs' directory.
ServerName
The name of the AIX server. Use when overriding the value set in the SymConfig activity.
SymNumber
Use when overriding the value in the SymConfig Activity. This parameter defaults to '000'.
UserName
The AIX UserName. Use when overriding the value in the SymConfig activity.
PCToLetterFile
Uploads a LetterFile from the PC to the FTP Server. The LetterFile is uploaded to the SYMnnn/LETTERSPECS directory, where nnn is a three-digit SYM Number (e.g., ‘007’).
JAMSUsername Any JAMS user.
LocalDirectory
The local directory is the upload location for the SYM LetterFile.
DisplayName
Used to modify the property name as displayed in the Designer panel.
Password
Use when overriding the value in the SymConfig Activity. As an alternative, if you wish to hide the password from viewing, (1) create a user in JAMS, (2) set the "Logon As" to the AIX Username, (3) click the password button, (4) enter the password for this account, and (5) then use that JAMS User Name in the JAMSUserName workflow property.
ServerFileName
The name of the LetterFile to upload to the '/SYMnnn/LETTERSPECS' directory on the FTP server.
ServerName
The name of the AIX Server (Use when overriding the value set in the SymConfig activity).
SymNumber
Use when overriding the value in the SymConfig Activity. This parameter defaults to '000'.
UserName
The AIX UserName. Use when overriding the value in the SymConfig activity.
PCToDataFile
Uploads a DataFile from the PC to the FTP server. The DataFile is uploaded to the SYMnnn/DATAFILES directory, where nnn is a three-digit SYM Number (e.g., ‘007’).
DisplayName
Used to modify the property name as displayed in the Designer panel.
Password
Use when overriding the value in the SymConfig Activity. As an alternative, if you wish to hide the password from viewing, (1) create a user in JAMS, (2) set the "Logon As" to the AIX Username, (3) click the password button and (4) enter the password for this account, and (5) then use that JAMS User Name in the JAMSUserName workflow property.
ServerName
The name of the AIX Server. (Use when overriding the value set in the SymConfig activity).
SymNumber
Use when overriding the value in the SymConfig Activity. This parameter defaults to '000' UserName
The AIX UserName. Use when overriding the value in the SymConfig activity.
DeleteLetterFile
Deletes a LetterFile from the ‘/SYMnnn/LETTERSPECS’ directory JAMS Username
Any JAMS user.
DisplayName
Use to modify the property name as displayed in the Designer panel.
Password
The AIX Password (Use when overriding the value in the SymConfig Activity). As an alternative, if you wish to hide the password from viewing, create a User in JAMS, set the "Logon As" to the AIX Username, click the password button and enter the password for this account, and then use that JAMS User Name in the JAMSUserName workflow property.
ServerFileName
The name of the LetterFile to delete from the '/SYMnnn/LETTERSPECS' Directory.
ServerName
The name of the AIX Server. Use when overriding the value set in the SymConfig activity.
SymNumber
RunJobFile
Runs a JobFile on the Symitar System. By default JobFiles are run in synchronous mode which means that the program will wait for the JobFile to finish
JAMSSymUserID Any JAMS user.
JAMS Username Any JAMS user.
JobFileBatchQueue
A numeric value (0-3) that will determine the batch queue to run the JobFile. Use 99 to find the first available empty queue. 0 will be used if 99 is specified and all queues are busy.
JobFileName
The name of the JobFile to run.
JobFileRunAsync
Determines if the JobFile is run in synchronous or asynchronous mode.
JobFileRunTimeoutInSecs
A numeric value (in seconds) that determines how long the program waits for the JobFile to finish before ending with an error.
SymopOperatorId Oper
SymUserId
SYM specific userid. Must be in the format of symuserid.password. As an alternative, if you want to hide your symuserid/password from viewing, (1) create a user in JAMS, (2) set the “Logon As”
to the symuserid, (3) click the password button and enter the password for this symuserid, and then (4) use that JAMS User Name in the JAMSSymUserID workflow property. JAMS will then correctly format the symuserid and password.
DisplayName
Use to modify the property name as displayed in the Designer panel.
Password
The AIX Password (Use when overriding the value in the SymConfig Activity). As an alternative, if you wish to hide the password from viewing, (1) create a User in JAMS, (2) set the "Logon As" to the AIX Username, (3) click the password button and enter the password for this account, and then (4) use that JAMS User Name in the JAMSUserName workflow property.
ServerName
The name of the AIX server. Use when overriding the value set in the SymConfig activity.
Sym
Use when overriding the value in the SymConfig Activity. This parameter defaults to '000'.
TelnetPort
Enter the port number. This parameter defaults to ‘23’.
Any JAMS User.
DisplayName
Use to modify the property name as displayed in the Designer panel.
Password
The AIX password. As an alternative, if you wish to hide the password from viewing, (1) create a user in JAMS, (2) set the "Logon As" to the AIX Username, (3) click the password button and (3) enter the password for this
account, and then (4) use that JAMS User Name in the JAMSUserName workflow property.
ServerFolderDirectory
The name of the LetterFile to delete from the '/SYMnnn/LETTERSPECS' directory.
ServerName
The name of the AIX Server ServerRunTimeoutInSecs
JAMS can execute SAS programs using the Windows Command Procedure Execution Method.
Below is an example of a SAS job-source:
c:\YourSASPath\sas.exe
-autoexec d:\sas\autoexec.sas -config d:\sas\config.sas