Automated STAR Queue Review

You can use the STAR (Scheduled Transmission And Retrieval) Job Queue to view and monitor scheduled jobs to transmit and/or retrieve files. If any job fails, you can edit the Queue Status to resubmit any file that was not originally sent. The Job Queue should be monitored after configuring the transmission and retrieval mailbox.

Prerequisites

You must have:

  • Common - Processes - View authorization

  • Financial Aid Automation - Processes - Automated Star Queue Review - View authorization

Access Method

Select the Processes tile > expand Financial Aid > select Automated STAR Queue Review.

Procedure to Review the STAR Job Queue

  1. Under Automated STAR Queue Review, specify the values.

    CampusesClosed The campus or campuses to which a person or item is assigned. It is filtered to display the campuses to which you have access. In some cases, it is also used to filter a list to only those items for the campus. In some lists, you can select more than one campus or select All. In lists that display columns, if the column contains more than one campus, you cannot sort or filter on that column.

    Date QueuedClosed The date and time when the batch job was queued From and To

    ProcessesClosed Which specific COD process (COD Import, COD Export, etc.)

    Queue StatusesClosed The status of the selected queue (Ready to Transmit, Transmitted, Failed, No Files, etc...)

  2. Select the Apply Filters button.

  3. Files created by an automated export or import process and the file transmission status are displayed in the grid. Review the following values.

    CampusClosed The campus or campuses to which a person or item is assigned. It is filtered to display the campuses to which you have access. In some cases, it is also used to filter a list to only those items for the campus. In some lists, you can select more than one campus or select All. In lists that display columns, if the column contains more than one campus, you cannot sort or filter on that column.

    Date QueuedClosed The date and time when the batch job was queued

    ProcessClosed Which specific COD process (COD Import, COD Export, etc.)

    Root File PathClosed The file path location for the job file.

    Queue StatusClosed The status of the selected queue (Ready to Transmit, Transmitted, Failed, No Files, etc...)

    Transmission TypeClosed The type of transmission to be performed (Transmit or Retrieve).

    Frozen statuses for files that were not processed (starcode9998 exception) can be reset by selecting within the Queue Status field to enable transmission and retrieval of COD files with no delays or errors. You can reset a frozen "Sending" status to "Ready to Send" and a frozen "Receiving" status to "Ready to Receive". Once this is reset, the frozen files (child row failed file) are updated to "Ready" status. After status updates are performed, transmission and retrieval only occur for those files that were not originally processed

    The Queue Status field will be non-selectable 24 hours after being changed to Sending/Receiving. A user can only select and configure this status once those 24 hours have elapsed. On consecutive status updates, the related date/time will always be the date/time of the latest status change. A REG key (Name - FAA STAR status Update. Description - Flip the FAA Automated STAR status to Ready to Send or Ready to Receive in minutes) is shown within the user interface. The value defaults to 24 hours but can be manually configured. For example, if the value is 1, that equals 1 minute. If the value is set to 60 minutes, it is shown as 1 hour.

  4. You can update a failed queue status to Ready to Transmit for transmission jobs or Ready to Retrieve for retrieval jobs, but you cannot update any other columns within the STAR job queue.

  5. There are three types of System Statuses: Automated Transmit, Automated Retrieve , and Manual Retrieve . Refer to the following table for the properties of each type.

    System Statuses
    Automation Type Transmission Type Queue Status
    Automated Transit System Statuses
    • Automated - > 
    • Transmit - > 
    • Ready to Transmit
    • Manual
    • Retrieve
    • Transmitting
    • Transmitted
    • Failed
    • Post Failed
    • No Files
    Automated Retrieve System Statuses
    • Automated -> 
    • Transmit
    • Manual
    • Retrieve - > 
    • Ready to Retrieve
    • Retrieving
    • Retrieved
    • Failed
    • Post Failed
    • No Files
    Manual Retrieve System Statuses
    • Automated
    • Manual - >
    • Transmit - >
    • Ready to Transmit
     
    • Retrieve
    • Transmitting
    • Transmitted
    • Failed
    • Post Failed
    • No Files

  6. The following File Transmission Statuses are used to track file transmission progress:

    • Ready to Transmit - Initial status for export files generated by a business process.

    • Sending - File transmission in progress by the Windows Automated Processing Service.

    • Sent - File transmission completed successfully to recipient.

    • Failed - File transmission failures, including connectivity, path error, file not found, etc.

    • Manual - Non-automated file transmission.

    • Post Failed - File not sent to entity.

    In CommonLine, Post Failed is only used for retrieval. It indicates the file retrieved from the remote host could not be transferred back to STAR WAPI, and the file is trapped on the Windows Automated Processing Service server.

  7. By right-selecting a job in the queue, you can:

    • Change an automated status to Manual to prevent the file from being automatically transmitted or retrieved.

    • Manually update a queue status of Failed to Ready to Send, Ready to Receive, or Ready to Retrieve when the queue status is Failed or Post Failed and all files in the transmission failed to transmit.

      If a request queue entry has been marked as Failed because all files in the transmission failed, then you can manually take corrective action to resolve the cause of the failure. After correcting the cause of the failure, you can manually update the request queue entry to Ready to Send or Ready to Receive, which will make the request available again to be selected by STAR automation.

    • Change an automated status to Manual if some files in the transmission were successfully transmitted and some files in the transmission failed. You then have to manually transmit the failed files, which changes the automation status and the queue status to Manual. When you change the status to Manual, then you can optionally record a comment explaining the reason for the manual action.

      Automatic retransmission of failed or successful requests is not included in this solution.

Caveats

The Scheduled Transmission and Retrieval process only submits files in a Ready to Send or Ready to Receive status. To use STAR without using the automated business processes provided by Anthology, you need to manually update the System Tracking File Status (set to Manual) by setting the files to an R status.

When campuses wish to automate import and/or export processes, each campus must be assigned a fully qualified "Uniform Naming Convention" (UNC) path to the server and the specific folder that stores the files exchanged for the campus in question. Paths assigned to campuses must be UNC-compliant and visible on the network.

  • For import processes, Anthology Student searches for inbound files in the folder specified by the UNC path provided in the path setup entry.

  • For export processes, Anthology Student places the outbound files in the folder specified in the path setup entry.

A fully qualified UNC path consists of a server name and one or more directory nodes separated by "\".

Example 

\\NFS\student information system\CL\Export

Where \\NFS identifies the server "NFS" and \student information system\CL\ and Export designates the folder path on server NFS.

The generic format of a UNC path is:

\\<server-name>\<share-name>\<directory-name>

Each directory in the path must be separated by "\".

For further assistance with setting up a UNC path for your automated processes, contact your system administrator.

 

This feature applies to U.S. compliance only.