Main Display Script: Post-Processing

'Tips for developers working within the Sysgem Enterprise Manager (SEM) environment'.

---

Variables set by the SEM framework:

SEM Display, Main Post-processing Script

The Perl script: "Post-processing" (invoked as a SEM Display Window is started) runs on the workstation that started the display.

The purpose of the script is to (optionally) format the SEM Agent output before the window is displayed.

This section describes the variables that are automatically preset at the start of the script by the SEM framework, and how the output data can be modified.

Editing the Post-Processing Script

The main display Post-processing script is found in the following place in the SEM Development Interface:

Variables:

The details of the variables stored automatically by the SEM framework at the start of script are shown below.

• Details of the Current SEM User:

Details of the SEM user that has invoked the display are stored in the following Perl variables:

   my $USER_NT_USERNAME      "Windows NT username"
   my $USER_NT_COMPUTER      "Windows NT computer name"
   my $USER_SYSGEM_USERNAME  "SYSGEM username"
   my $USER_DISPLAY_VERBOSE  "Verbose display option (either 0 or 1)"
   my $SEM_CLIENT_BUILD      "SEM Client Build (e.g. 2.3 4459)"

• Details from the Startup Window:

Details of the Data Entered in the field in the Startup Window are shown in the following variables:

   my $INPUT_SV   "The Agent(s) selected for connecting to this display"
   my $INPUT_XX   "The values of the fields entered in the startup window - XX is the field code for each parameter field"

• Details about the SEM Agent:

Details of the SEM Agent are shown in the following variables:

   my $server_name      "The Agent that has just returned data"
   my $server_type      "The Agent platform type... 'Windows 2000\/NT' / 'UNIX' / 'VMS' "
   my $server_sub_type  "The Agent platform sub type .... such as 'Linux' when $server_type = 'UNIX'"
   my @CurrentServers   "An array of all the agents requested to be connected" 
   my @ConnectedAgents  "An array showing those agents that have so far acknowleged their presence (but not necessarily returned their data yet!)"

• Data Returned from the Agent

Details of the output returned from the SEM Agent are shown in the following array:

   my @input_array = ();   # Array to hold the output from the Agent that is sent as input to Post Processing

   sub LoadInputArray      # Call this subroutine to fill the array @input_array

• Control Information

A count of the number of time the window has been refreshed is contained in the following variable:

   my $LOOP_COUNTER        # Starts at 0 and is incremented everytime the window is refreshed.

• Details of the Authorization Server

Details of the Authorization Server are shown in the following variables:

  my $USE_AUTH_SVR_PROXY   "Whether the Authorization Server may be used for DB access (either 0 or 1)"
  my $AUTH_SVR_ADDRESS     "The address of the Authorization Server as used in the SEM Login window"
  my $AUTH_SVR_PORT        "The port number of the Authorization Server as used in the SEM Login window"

• License Information

License information is shown in the following variables:

   my $LICENSED_TO_COMPANY
   my $LICENSED_TO_CITY
   my $LICENSED_TO_ZIP_CODE
   my $LICENSED_TO_COUNTRY

---

'Output from the Post-procesing Script'

If the output from the Agent is to be modified before it is displayed in the window, then read Suppress Agent Output in Post-process for more information.

Other printed output recognised by the SEM framework includes the display of a dialogue box. See Dialogue Boxes for more information.