Skip to main content

ACS Ease Operation

Once the sma.acs.ACSEase plugin has been registered with the OpCon system, it will be possible to perform agent and task definitions. All definitions can only be performed using Solution Manager.

Defining ACS Ease connection​

The Agent definition is define the connection between your local OpCon system and the target Ease DataCenter OpCon system. This is done by adding a new ACS Ease Agent definition using Solution Manager.

Items defined in red are required values (note : global properties are supported).

Defining a Connection

  1. Open Solution Manager.
  2. From the Home page select Library
  3. From the Administration Menu select Agents.
  4. Select +Add to add a new agent definition.
  5. Fill in the agent details
    • Insert a unique name for the connection.
    • Select ACS Ease from the Type drop-down list.
    • Select General Settings
    • Check that the NetCom Name is set to Default or the SMA Relay name if Relay is being used.
    • Select ACS Ease Settings
    • In the Customer Id field enter customer number provided by the Ease DataCenter.
    • In the Retain Log Files field enter a value defining the number of days to retain log files (default is 30 days).
    • In the Ease DataCenter section
      • In the Ease URL filed enter the host and port number provided by the Ease DataCenter (host:port).
      • In the Ease User field enter the user name provided by the Ease DataCenter.
      • In the Ease User Password filed enter the password associated with the provided Ease User.
  6. Save the definition changes.
  7. Start the connection by selecting the Change Communication Status button and selecting Enable Full Comm..

Defining tasks​

The ACS Ease Connection supports the following task types:

Task TypeDescription
COPY-DATA-TO-LTRFILECopy outgoing Data File to Letter Files for FTP
COPY-RENAME-LTRFILE-OUTCopy or Rename Letter File for FTP
COPY-RPT-OUTCopy Report to Letter Files for FTP
FILEPERMSUpdate Letter File Privileges to 774
MONITORFile Monitor for Incoming File
MOVE-LTRFILE-TO-DATAMove incoming Letter File to Data Files
PROMPTAnswer a Single Prompt
PROMPTSEQAnswer a Single Prompt with a SEQ
RUN-FTP-OUTFTP Letter File off Symitar
RENAME-LTRFILE-INRename Letter File Removing Prefix
RESETReset a Single Prompt
RSJRun Symitar Job (single-threaded)
RSJEDITRuns Symitar Job with Edit File
RSJMULTIRun Symitar Job (multi-threaded)
SEQCollect the SEQ of a Report
SEQ-SENDCopy Specified SEQ to Reports for FTP
TRANSLATE2COMMASAnswer a Single Prompt containing commas

Defining tasks only requires providing the values associated with the specific task. It is possible to use global properties when defining tasks.

COPY-DATA-TO-LTRFILE Task​

Defining a COPY-DATA-TO-LTRFILE Master Job

  1. Open Solution Manager.
  2. From the Home page select Library
  3. From the Administration Menu select Master Jobs.
  4. Select +Add to add a new master job definition.
  5. Fill in the task details.
    • Select the Schedule name from the drop-down list.
    • In the Name field enter a unique name for the task within the schedule.
    • Select ACS Ease from the Job Type drop-down list.
    • Select COPY-DATA-TO-LTRFILE : Copy outgoing Data File to Letter Files for FTP from the Task Type drop-down list.

Enter details for Task Type COPY-DATA-TO-LTRFILE.

  1. Select the Task Details button.
  2. In the Integration Selection section, select the primary integration which is an ACSEase connection previously defined.
  3. In the TaskConfiguration section
    • In the Identifier field enter a unique identifier for the task.
    • In the Source File field enter the source file name associated with the task.
    • In the Output File field enter the output file name associated with the task.
  4. Save the definition changes.

COPY-RENAME-LTRFILE-OUT Task​

Defining a COPY-RENAME-LTRFILE-OUT Master Job

  1. Open Solution Manager.
  2. From the Home page select Library
  3. From the Administration Menu select Master Jobs.
  4. Select +Add to add a new master job definition.
  5. Fill in the task details.
    • Select the Schedule name from the drop-down list.
    • In the Name field enter a unique name for the task within the schedule.
    • Select ACS Ease from the Job Type drop-down list.
    • Select COPY-RENAME-LTRFILE-OUT : Copy or Rename Letter File for FTP from the Task Type drop-down list.

Enter details for Task Type COPY-RENAME-LTRFILE-OUT.

  1. Select the Task Details button.
  2. In the Integration Selection section, select the primary integration which is an ACSEase connection previously defined.
  3. In the TaskConfiguration section
    • In the Identifier field enter a unique identifier for the task.
    • select an Action from the Action drop-down list.
    • In the Source File field enter the source file name associated with the task.
    • In the Output File field enter the output file name associated with the task.
  4. Save the definition changes.

COPY-RPT-OUT Task​

Defining a COPY-RPT-OUT Master Job

  1. Open Solution Manager.
  2. From the Home page select Library
  3. From the Administration Menu select Master Jobs.
  4. Select +Add to add a new master job definition.
  5. Fill in the task details.
    • Select the Schedule name from the drop-down list.
    • In the Name field enter a unique name for the task within the schedule.
    • Select ACS Ease from the Job Type drop-down list.
    • Select COPY-RPT-OUT : Copy Report to Letter Files for FTP from the Task Type drop-down list.

Enter details for Task Type COPY-RPT-OUT.

  1. Select the Task Details button.
  2. In the Integration Selection section, select the primary integration which is an ACSEase connection previously defined.
  3. In the TaskConfiguration section
    • In the Identifier field enter a unique identifier for the task.
    • In the Output File field enter the output file name associated with the task.
  4. Save the definition changes.

FILEPERMS Task​

Defining a FILEPERMS Master Job

  1. Open Solution Manager.
  2. From the Home page select Library
  3. From the Administration Menu select Master Jobs.
  4. Select +Add to add a new master job definition.
  5. Fill in the task details.
    • Select the Schedule name from the drop-down list.
    • In the Name field enter a unique name for the task within the schedule.
    • Select ACS Ease from the Job Type drop-down list.
    • Select FILEPERMS : Update Letter File Privileges to 774 from the Task Type drop-down list.

Enter details for Task Type FILEPERMS.

  1. Select the Task Details button.
  2. In the Integration Selection section, select the primary integration which is an ACSEase connection previously defined.
  3. In the TaskConfiguration section
    • In the Identifier field enter a unique identifier for the task.
    • In the File field enter the letter file name whose privileges will be updated.
  4. Save the definition changes.

MONITOR Task​

Defining a MONITOR Master Job

  1. Open Solution Manager.
  2. From the Home page select Library
  3. From the Administration Menu select Master Jobs.
  4. Select +Add to add a new master job definition.
  5. Fill in the task details.
    • Select the Schedule name from the drop-down list.
    • In the Name field enter a unique name for the task within the schedule.
    • Select ACS Ease from the Job Type drop-down list.
    • Select MONITOR : File Monitor for Incoming File from the Task Type drop-down list.

Enter details for Task Type MONITOR.

  1. Select the Task Details button.
  2. In the Integration Selection section, select the primary integration which is an ACSEase connection previously defined.
  3. In the TaskConfiguration section
    • In the Identifier field enter a unique identifier for the task.
    • In the File field enter the monitor file name associated with the task.
  4. Save the definition changes.

MOVE-LTRFILE-TO-DATA Task​

Defining a MOVE-LTRFILE-TO-DATA Master Job

  1. Open Solution Manager.
  2. From the Home page select Library
  3. From the Administration Menu select Master Jobs.
  4. Select +Add to add a new master job definition.
  5. Fill in the task details.
    • Select the Schedule name from the drop-down list.
    • In the Name field enter a unique name for the task within the schedule.
    • Select ACS Ease from the Job Type drop-down list.
    • Select MOVE-LTRFILE-TO-DATA : Move incoming Letter File to Data Files from the Task Type drop-down list.

Enter details for Task Type MOVE-LTRFILE-TO-DATA.

  1. Select the Task Details button.
  2. In the Integration Selection section, select the primary integration which is an ACSEase connection previously defined.
  3. In the TaskConfiguration section
    • In the Identifier field enter a unique identifier for the task.
    • In the Source File field enter the source file name associated with the task.
    • In the Output File field enter the output file name associated with the task.
  4. Save the definition changes.

PROMPT Task​

Defining a PROMPT Master Job

  1. Open Solution Manager.
  2. From the Home page select Library
  3. From the Administration Menu select Master Jobs.
  4. Select +Add to add a new master job definition.
  5. Fill in the task details.
    • Select the Schedule name from the drop-down list.
    • In the Name field enter a unique name for the task within the schedule.
    • Select ACS Ease from the Job Type drop-down list.
    • Select PROMPT : Answer a Single Prompt from the Task Type drop-down list.

Enter details for Task Type PROMPT.

  1. Select the Task Details button.
  2. In the Integration Selection section, select the primary integration which is an ACSEase connection previously defined.
  3. In the TaskConfiguration section
    • In the Identifier field enter a unique identifier for the task.
    • In the Job Name field enter the the name of the RSJ job associated with this request.
    • In the Prompt field enter prompt.
    • In the Response field enter the response to the associated prompt.
  4. Save the definition changes.

PROMPTSEQ Task​

Defining a PROMPTSEQ Master Job

  1. Open Solution Manager.
  2. From the Home page select Library
  3. From the Administration Menu select Master Jobs.
  4. Select +Add to add a new master job definition.
  5. Fill in the task details.
    • Select the Schedule name from the drop-down list.
    • In the Name field enter a unique name for the task within the schedule.
    • Select ACS Ease from the Job Type drop-down list.
    • Select PROMPTSEQ : Answer a Single Prompt with a SEQ from the Task Type drop-down list.

Enter details for Task Type PROMPTSEQ.

  1. Select the Task Details button.
  2. In the Integration Selection section, select the primary integration which is an ACSEase connection previously defined.
  3. In the TaskConfiguration section
    • In the Identifier field enter a unique identifier for the task.
    • In the Job Name field enter the name of the RSJ job associated with this request.
    • In the Prompt field enter prompt to submit.
  4. Save the definition changes.

RUN-FTP-OUT Task​

Defining a RUN-FTP-OUT Master Job

  1. Open Solution Manager.
  2. From the Home page select Library
  3. From the Administration Menu select Master Jobs.
  4. Select +Add to add a new master job definition.
  5. Fill in the task details.
    • Select the Schedule name from the drop-down list.
    • In the Name field enter a unique name for the task within the schedule.
    • Select ACS Ease from the Job Type drop-down list.
    • Select RUN-FTP-OUT : FTP Letter File off Symitar from the Task Type drop-down list.

Enter details for Task Type RUN-FTP-OUT.

  1. Select the Task Details button.
  2. In the Integration Selection section, select the primary integration which is an ACSEase connection previously defined.
  3. In the TaskConfiguration section
    • In the Identifier field enter a unique identifier for the task.
    • In the Output File field enter the output file name associated with the task.
    • In the Email field enter an email address that will receive notification when the transfer is complete.
  4. Save the definition changes.

RENAME-LTRFILE-IN Task​

Defining a RENAME-LTRFILE-IN Master Job

  1. Open Solution Manager.
  2. From the Home page select Library
  3. From the Administration Menu select Master Jobs.
  4. Select +Add to add a new master job definition.
  5. Fill in the task details.
    • Select the Schedule name from the drop-down list.
    • In the Name field enter a unique name for the task within the schedule.
    • Select ACSEase from the Job Type drop-down list.
    • Select RENAME-LTRFILE-IN : Rename Letter File Removing Prefix from the Task Type drop-down list.

Enter details for Task Type RENAME-LTRFILE-IN.

  1. Select the Task Details button.
  2. In the Integration Selection section, select the primary integration which is an ACSEase connection previously defined.
  3. In the TaskConfiguration section
    • In the Identifier field enter a unique identifier for the task.
    • select an Action from the Action drop-down list.
    • In the Source File field enter the source file name associated with the task.
    • In the Output File field enter the output file name associated with the task.
  4. Save the definition changes.

RSJ Task​

Defining a RSJ Master Job

  1. Open Solution Manager.
  2. From the Home page select Library
  3. From the Administration Menu select Master Jobs.
  4. Select +Add to add a new master job definition.
  5. Fill in the task details.
    • Select the Schedule name from the drop-down list.
    • In the Name field enter a unique name for the task within the schedule.
    • Select ACS Ease from the Job Type drop-down list.
    • Select RSJ : Run Symitar Job (single-threaded) from the Task Type drop-down list.

Enter details for Task Type RSJ.

  1. Select the Task Details button.
  2. In the Integration Selection section, select the primary integration which is an ACSEase connection previously defined.
  3. In the TaskConfiguration section
    • In the Job Name field enter the the name of the RSJ job associated with this request.
  4. Save the definition changes.

RSJEDIT Task​

Defining a RSJEDIT Master Job

  1. Open Solution Manager.
  2. From the Home page select Library
  3. From the Administration Menu select Master Jobs.
  4. Select +Add to add a new master job definition.
  5. Fill in the task details.
    • Select the Schedule name from the drop-down list.
    • In the Name field enter a unique name for the task within the schedule.
    • Select ACS Ease from the Job Type drop-down list.
    • Select RSJEDIT :Runs Symitar Job with Edit File from the Task Type drop-down list.

Enter details for Task Type RSJEDIT.

  1. Select the Task Details button.
  2. In the Integration Selection section, select the primary integration which is an ACSEase connection previously defined.
  3. In the TaskConfiguration section
    • In the Identifier field enter a unique identifier for the task.
    • In the Job Name field enter the name of the RSJ job associated with this request.
    • In the Edit File field enter the edit file name associated with the task.
  4. Save the definition changes.

RSJMULTI Task​

Defining a RSJMULTI Master Job

  1. Open Solution Manager.
  2. From the Home page select Library
  3. From the Administration Menu select Master Jobs.
  4. Select +Add to add a new master job definition.
  5. Fill in the task details.
    • Select the Schedule name from the drop-down list.
    • In the Name field enter a unique name for the task within the schedule.
    • Select ACS Ease from the Job Type drop-down list.
    • Select RSJMULTI : Run Symitar Job (multi-threaded) from the Task Type drop-down list.

Enter details for Task Type RSJMULTI.

  1. Select the Task Details button.
  2. In the Integration Selection section, select the primary integration which is an ACSEase connection previously defined.
  3. In the TaskConfiguration section
    • In the Identifier field enter a unique identifier for the task.
    • In the Job Name field enter the name of the RSJ job associated with this request.
  4. Save the definition changes.

SEQ Task​

Defining a SEQ Master Job

  1. Open Solution Manager.
  2. From the Home page select Library
  3. From the Administration Menu select Master Jobs.
  4. Select +Add to add a new master job definition.
  5. Fill in the task details.
    • Select the Schedule name from the drop-down list.
    • In the Name field enter a unique name for the task within the schedule.
    • Select ACS Ease from the Job Type drop-down list.
    • Select SEQ : Collect the SEQ of a Report from the Task Type drop-down list.

Enter details for Task Type SEQ.

  1. Select the Task Details button.
  2. In the Integration Selection section, select the primary integration which is an ACSEase connection previously defined.
  3. In the TaskConfiguration section
    • In the Identifier field enter a unique identifier for the task.
    • In the Job Name field enter the name of the RSJ job associated with this request.
    • In the Report Name field enter the report name associated with the task.
  4. Save the definition changes.

SEQ-SEND Task​

Defining a SEQ-SEND Master Job

  1. Open Solution Manager.
  2. From the Home page select Library
  3. From the Administration Menu select Master Jobs.
  4. Select +Add to add a new master job definition.
  5. Fill in the task details.
    • Select the Schedule name from the drop-down list.
    • In the Name field enter a unique name for the task within the schedule.
    • Select ACS Ease from the Job Type drop-down list.
    • Select SEQ-SEND : Copy Specified SEQ to Reports for FTP from the Task Type drop-down list.

Enter details for Task Type SEQ-SEND.

  1. Select the Task Details button.
  2. In the Integration Selection section, select the primary integration which is an ACSEase connection previously defined.
  3. In the TaskConfiguration section
    • In the Identifier field enter a unique identifier for the task.
    • In the Seq field enter the six digit number of the desired report.
  4. Save the definition changes.

STRANSLATE2COMMAS Task​

Defining a TRANSLATE2COMMAS Master Job

  1. Open Solution Manager.
  2. From the Home page select Library
  3. From the Administration Menu select Master Jobs.
  4. Select +Add to add a new master job definition.
  5. Fill in the task details.
    • Select the Schedule name from the drop-down list.
    • In the Name field enter a unique name for the task within the schedule.
    • Select ACS Ease from the Job Type drop-down list.
    • Select TRANSLATE2COMMAS : Answer a Single Prompt containing commas from the Task Type drop-down list.

Enter details for Task Type STRANSLATE2COMMAS.

  1. Select the Task Details button.
  2. In the Integration Selection section, select the primary integration which is an ACSEase connection previously defined.
  3. In the TaskConfiguration section
    • In the Identifier field enter a unique identifier for the task.
    • In the Prompt field enter the prompt value for the job.
    • In the Response field enter the response with (^) that will be converted to commas (,).
  4. Save the definition changes.