Appendix - Common Library System Defaults
Overview
System Defaults are values that control how Halcyon products operate, in the same way that system values affect the i5/OS operating system.
The Work with System Defaults display, available from the option 7 from the Halcyon Configuration menu lists the available system defaults and provides options enabling you to display or change settings.
System Default Authority
In order to actively use this display, you need *USE authority to the WRKSYSDF function.
In addition, you need *ALL or *USE authority to the SYSDFT function in each product of which you need to maintain or view the system defaults.

This entry specifies the number of minutes for which a rule should be suspended when an acknowledgment is received for an alert. If the rule accepts variable conditions, such as generic names or has variable types, the suspension only applies to the specific values of the alert. The default value is 5 minutes.
0-1440 | Enter the number of minutes for which the rule is suspended |

Specifies the number of days messages are retained in the Action Log before being automatically deleted.
1-365 | Specify the number of days |
*NOMAX | Messages are not automatically deleted. Use the Clear Action Log (CLRACTLOG) command to manually purge the Action Log |

Specifies the target maximum busy percentage value for Action Monitors. This value is compared to the actual busy percentage value of the Action Monitors to determine the optimum number of Action Monitors to run, within the limits specified by the HAL/ACTMONMIN and HAL/ACTMONMAX system defaults.

Specifies the maximum number of Auxiliary Action Monitors that are run. See HAL/ACTMAXBUSY.

Specifies the minimum number of Auxiliary Action Monitors that are run. See HAL/ACTMAXBUSY.

Specifies the run priority of the Primary and Auxiliary Action Monitors.
*DFT | The run priority specified in system default HAL/DFTMONPTY is used |
1-99 | Specify the run priority value for the Action Monitors |

Specifies the user profile used when running the Primary and Auxiliary Action Monitors.
*JOBD | The user profile in the STRMON job description is used. This value is shown in the HAL/MONUSRPRF system default |
1-99 | Enter a specific user profile |

Specifies the message queue to which administrator messages are sent. These would include messages such as those warning of an imminent authorization code expiry date.

Specifies the number of days for which Open and Acknowledged alerts are retained in the Alert Log before being closed automatically.
7-365 |
Specify the number of days |
*NONE | Alerts are not closed automatically |

Specifies the qualified name and library of the program to be called whenever a local alert is closed.
*NONE |
No exit program is specified | ||||||||||||||||||||||
name | Enter the name and library of the program to call . The user program is passed the following parameters
|
||||||||||||||||||||||
The possible values for the method parameter are:
|
|||||||||||||||||||||||
The user program may retrieve additional information about the alert from substitution variables. For example, the text of the alert can be retrieved using: RTVSBSVAR VAR(ALERT) ALERT(&ALERTID) CHAR256(&TEXT) |

Specifies the number of days that closed alerts are retained in the Alert Log before being automatically deleted. The number of days is measured from when the alert was logged, not from when it was closed.
1-365 |
Specify the number of days |
*NOMAX | Closed alerts are not automatically deleted. Use the Clear Alert log (CLRALTLOG) command to manually purge the Alert Log |

Specifies the authority control mode used.
0 |
Users with *ALLOBJ special authority do not automatically have *ALL authority to Halcyon products and functions. Authority is derived from function authority in the normal way |
1 | Users with *ALLOBJ special authority automatically have *ALL authority to all Halcyon products and functions, overriding any previous function authority that has been defined. This is the default setting |

Specify whether and how to automatically export rules to remote systems.
*OFF | Automatic export is disabled |
*UPPADD | Automatic export is enabled in add-update mode. Changing (but not adding) a rule group or rule causes that rule or group to be added or updated on the systems enabled for auto-export |
*UPDATE |
Automatic export is enabled in update only mode. Changing (but not adding) a rule group or rule causes that group or rule to be updated on the systems enabled for auto-export. It is not added to those systems if it does not already exist. With this setting, if you require a rule group or rule on a remote system to be automatically updated in future, you must first manually export it using option 13=Export on the Work with Rules display or by using the Export Rules (EXPRULE) command. Once created on the remote system, it is automatically updated with any subsequent changes on the source system |

Specifies the automatic export retry interval in minutes. If an automatic export cannot connect to the remote system, additional attempts are made at the interval specified here until the export is successful or until the time-out specified by system default HAL/AUTOEXPORTTMOUT expires.

Specifies the automatic export time-out in hours. If an automatic export cannot connect to the remote system, additional attempts are made at the interval specified by system default HAL/AUTOEXPORTRETRY until the export is successful or until the time-out specified here elapses.

Specifies the number of years of default data with which the *DEFAULT calendar should be automatically populated on an ongoing basis.
The default data sets the *DEFAULT calendar on Mondays through Fridays using the times specified by system defaults HAL/CALDFTSTRTIME and HAL/CALDFTENDTIME. The data is added in whole years. A year is only populated if that year previously contained no enabled dates.
*NONE | The *DEFAULT calendar is not automatically populated |
1-20 | Specify the number of years to automatically populate the *DEFAULT calendar, including the current year. For example, in 2012, a value of 5 would add data to any unpopulated years between 2012 and 2016. Then in 2013, the data for 2017 would also be populated |

Specifies the command character for the Clear Day option on the Work with Calendars display.

Specifies the command character for the End of Contiguous Days option on the Work with Calendars display.

Specifies the command character for the Set Day option on the Work with Calendars display.

Specifies the command character for the Start of Contiguous Days option on the Work with Calendars display.

Specifies the command character for the View Day option on the Work with Calendars display.

Specifies the default end of day time used with the various calendar and schedule related options.

Specifies the default start of day time used with the various calendar and schedule related options.

Specifies the number of days warning that is given for calendar expiry. A warning message is sent to the message queue defined in HAL/ADMINMSGQ for each calendar that does not have any days set ‘on’ beyond the current date plus the number of days specified in this system default.
7-365 | Enter the number of days |
*NOMSG | No warning messages are issued |

Specifies whether to automatically delete temporary product authorization codes that have expired. The default setting is *YES.
*YES | Enter the number of days |
*NOMSG | No warning messages are issued |

Specifies whether this environment accepts product authorization codes entered via a Code Upload utility.
*YES | Code uploads are accepted so long as the codes are valid |
*NO | Code uploads are rejected in this environment |

Specifies the number of days that Closed alerts are retained by the ‘green-screen’ Message Console before being automatically deleted. This system default has no effect on the PC-based Enterprise Console. The number of days is measured from when an alert was logged and not from when it was closed.
1-365 | Specify the number of days |
*NOMAX | Closed alerts are not automatically deleted from the Message Console. Use the Clear Message Console (CLRMSGCON) command to manually purge the Message Console |
*NONE | Closed alerts are not retained |

Specifies the default color control scheme used by Message Console. The actual scheme may be changed individually by each user via use of F16=User Options on the Message Console display.
*SYS | The default scheme is set by system. The color scheme can be modified by taking option 2=System Attributes from the Message Console - Systems View |
*SEV | The default scheme is set by message severity. The color scheme may be modified using F22=Alert Attributes from the Message Console - Alerts View |

Specifies the default directory used for stream file output, such as PDF and CSV files.The initial value is automatically set during installation and depends on the environment name. For environment name PROD, the installer sets the default directory to /Halcyon/HALPROD, creates the directory and shares the sub-directory. If this value is subsequently changed, the user is responsible for creating and sharing the specified directory.

System logos are shown on graphical PDF reports and are defined for each i5 system using option 25=Change System Logo on the Work with Remote Locations display.
The default value is *DFT. This system default, and the associated HAL/DFTLOGOPOSITION system default, determine the logo and logo positioning used when *DFT is specified.
*HALCYON | The Halcyon Software logo is used as the default logo |
*HELPSYS | The HelpSystems logo is used as the default logo |
path | Specify the path of the JPEG file that contains the default logo |

System logos are shown on graphical PDF reports and are defined for each i5 system using option 25=Change System Logo on the Work with Remote Locations display. The default value is *DFT. This system default, and the associated HAL/DFTLOGO system default, determine the logo and logo positioning used when *DFT is specified.
*LEFT | The logo is positioned at the upper left position of the logo space and trimmed if necessary |
*SCALE | The logo is centralized and symmetrically scaled to the maximum size that will fit in the logo space |
*CENTRE | The logo is centralized and trimmed if necessary |
*FILL | The logo is centralized and asymmetrically scaled to completely fill the logo space |

Specifies the default run priority for the Halcyon monitors and agents. The run priority selected here, is used when the specific monitor run priority is set to *DFT. Each monitor has its own system default setting which may be set to override the setting entered here.
Value 1-99 | Specify the default run priority. The default value setting is 40 |

Specifies the default message for Action Schedule (ACTSCH) actions. This message may comprise fixed text and/or substitution variables. Press F16=Substitution variables to view a list of valid substitution variables.

Specifies the default message for console alert (CONSOLE) actions. This message may comprise fixed text and/or substitution variables. Press F16=Substitution variables to view a list of valid substitution variables.

Specifies the default message for Send Message Queue Message (SNDMSG) actions. This setting defaults to the alert text. This message may comprise fixed text and/or substitution variables. Press F16=Substitution variables to view a list of valid substitution variables.

Specifies the default message for the Send Text Message (SNDTXT) actions. This setting defaults to the system name and the alert. This message may comprise fixed text and/or substitution variables. Press F16=Substitution variables to view a list of valid substitution variables.

Specifies the default value for the Open Alert Action option for rules. This option specifies which action is performed for previously raised alerts if the alerting criteria no longer applies.
*NONE | Take no action. All previous alerts remain unchanged |
*ACK | Any open alerts raised by this rule are acknowledged |
*CLOSE | Any open alerts raised by this rule are closed |

Specifies the default subject for the Send Text Message (SNDTXT) actions. The subject line is only used when the message is sent as an email.
*AUTO |
The subject comprises the first sentence of the text sent in the message. Specifically, the beginning of the text up to the first occurrence of a period (.) followed by a space is used. The maximum Subject length is 44 characters |
*ACK | Specify the actual subject text. This text may include substitution variables. Permitted substitution variables can be retrieved by pressing F16 |

Specifies whether the primary handler programs are to be used as the registered exit programs for the various exit points used by Halcyon products, or whether a different program is to be used.
A number of exit points used by more than one Halcyon product have a limit of one exit program. In addition, you may have additional software that requires use of a particular exit point. The solution is to register primary handlers to each exit point, and have the primary handlers call each secondary handler in turn. You can use the default primary handlers or you can provide your own.
*HALCYON |
The Halcyon primary handlers are used. These programs may be registered using the Set Exit Points (SETEXITPNT) command or the Work with Exit Point Handlers display. The Halcyon primary handlers call Halcyon secondary handler in each product as required. If you have other software that requires use of the same exit points, you can arrange for the Halcyon primary handlers to call your exit programs by defining your exit programs as user defined secondary handlers on the Work with Exit Point Handlers display |
*USER | Provide your own primary handler programs. In this instance, your own programs must be the registered exit programs. You must configure your exit programs to subsequently call the appropriate Halcyon primary handler for each exit point |

Specifies the action to be taken when the user requests a Halcyon menu with incompatible job attributes. The job attributes are incompatible when both the following are true:
-
Coded character set identifier (CCSID) is set to 65535
-
Default coded character set identifier (DFTCCSID) is not set to 37
These settings cause incorrect storage and retrieval of data in the Halcyon database. Specify the correct cause of action to take:
*ERRMSG |
Issue an error message and prevent access to the Halcyon system |
*JOBDFT | Automatically change the coded character set identifier (CCSID) to the value of the default coded character set identifier (DFTCCSID) |

Specifies the number of days to retain journal receivers after they are detached. The Halcyon Action Monitor automatically deletes journal receivers older than this number of days.
1-365 |
Specify the number of days to retain data |
*NOMAX | Journal receivers are not automatically deleted. Use the Purge Journal (CLRJRNRCV) command to manually purge the journal receivers |

Specifies the size in Kb for each newly created receiver. The Halcyon journal receivers are automatically changed by the system once this size is exceeded.
100000 to 1000000000 |
Specify number of Kb (min is 100000) |

Specifies the maximum time-out value used when attempting to connect to a remote system. The minimum time-out value is two seconds. The actual time-out value used when connecting to a remote system is calculated from previous successful connection times. This system default sets the upper limit of the calculated value. If the remote system cannot be contacted in the time allowed, it is assumed to be unreachable.

Specifies the user profiles associated with job descriptions; Start Monitors (STRMON), Start Subsystem (STRSBS) and Supervisor (SUPERVISOR). If *VARY is shown, this indicates that the job descriptions have different user profiles. Change the value as required and press Enter to change the user profile associated with all three job descriptions. Changing the value to *VARY has no effect.
The user profiles can also be changed using the Change Job Description (CHGJOBD) command.

Specifies the number of days for which messages are retained in the Message Log before being automatically deleted.
1-365 |
Specify the number of days |
*NOMAX | Messages are not automatically deleted. Use the Clear Message Log (CLRMSGLOG) command to manually clear the message log |

Specifies whether to automatically define a remote location when valid network data is received from a previously unknown system or environment.
*YES |
A new remote location is automatically defined and the incoming data is accepted |
*NO | The incoming data is rejected |

Specifies the default value of the Allow Automatic Update parameter used when new remote locations are added automatically.
*YES |
When applicable, Allow automatic update is set to *YES |
*NO | Allow automatic update is set to *NO |

Specifies whether to delete inactive (not connecting to this system) i5 systems from the Work with Remote Locations display.
*OFF |
Inactive i5 systems are not automatically deleted |
1-365 | Inactive i5 systems are automatically deleted from the Work with Remote Locations display after the number of specified days |

Specifies whether to delete inactive (not connecting to this system) PC systems from the Work with Remote Locations display.
*OFF |
Inactive PC systems are not automatically deleted |
1-365 |
Inactive PC systems are automatically deleted from the Work with Remote Locations display after the number of specified days |

Specifies the logging level of Network Manager diagnostics.
*HIGH |
Error and diagnostic messages as well as additional operational messages are logged. If network problems are being encountered, the additional information may assist technical support in resolving the issue |
*NORMAL |
Error and diagnostic messages are logged. This is the recommended and default value |
*LOW | Only error messages are logged. No diagnostic messages are logged |

Specifies the number of days for which messages are retained in the Network Log before being automatically deleted.
1-365 |
Specify the number of days |
*NOMAX |
Messages are not automatically deleted. Use the Clear Network Log (CLRNETLOG) command to manually clear the Message Log |

Specifies whether failed remote system communications checks are logged to the Message Log.
*YES |
Each communications check which failed is logged |
*NO |
Communication checks are not logged |

Specifies the run priority of the Network Monitor.
*DFT |
The run priority specified in system default HAL/DFTMONPTY is used |
1-99 |
Specify the run priority value for the Network Monitor |

Specifies the user profile to be used when running the Network Send and Network Receive Primary and Auxiliary Monitors.
*JOBD |
The user profile within the STRMON job description is used. This value is shown in the HAL/MONUSRPRF system default |
user |
Enter a specific user profile |

Specifies the threshold at which to log a warning message regarding slow receive form a remote system. The value specified here is the percentage of the Receive Wait Time-Out value specified on the Work with Remote Locations display. This value must be exceeded for a message to be logged.
For example, if Receive Wait Time-Out for a system is set to 1000mS and this system default is set to 50mS, a message is logged if the if a receive took more than 500mS.
1-99 | Specify the threshold percentage above which warning messages are logged |
*OFF | Slow receive messages are not logged |

Specifies the method used by the various export commands to transfer data to a remote system. The setting in this system default applies to the following commands:
-
Export Action Schedules (EXPACTSCH)
-
Export Call Schedules (EXPCALLSCH)
-
Export Rules (EXPRULE)
-
Export User Authorities (EXPUSRAUT)
-
Export Group (EXPGRP)
*FTP | Data is exported using *FTP |
*NETMGR |
Data is exported using Network Manager |

Specifies the number of days warning that is given for permanent authorization codes where the maintenance is about to expire. The warning message is sent to the message queue defined in the HAL/ADMINMSGQ system default.
1 to 90 | Specify the number of days |
*NOMSG | No warning messages are issued |

Specifies the qualified name of a secondary exit program for exit point QIBM_QTMF_CLIENT_REQ with format VLRQ0100.
Exit point QIBM_QTMF_CLIENT_REQ with format VLRQ0100 may be used by a number of Halcyon products but has a limit of one exit program. Therefore the software uses a primary exit program (HAL_QTMFCR) to call one or more secondary Halcyon exit programs as required. If you have other software that requires use of this exit point, you can arrange for the Halcyon primary exit program to call your exit program by defining your exit program using this system default.
*NONE | No secondary exit program is specified |
Name | Specify the name and library of the exit program to call |
SETEXITPNT PRIMARY(*ENABLE)

Specifies the qualified name of a secondary exit program for exit point QIBM_QTMF_SERVER_REQ with format VLRQ0100.
Exit point QIBM_QTMF_SERVER_REQ with format VLRQ0100 may be used by a number of Halcyon products but has a limit of one exit program.
Therefore Halcyon uses a primary exit program (HAL_QTMFSR) to call one or more secondary Halcyon exit programs as required.
If you have other software that requires use of this exit point, you can arrange for the Halcyon primary exit program to call your exit program by defining your exit program using this system default.
*NONE | No secondary exit program is specified |
Name | Specify the name and library of the exit program to call |
SETEXITPNT PRIMARY(*ENABLE)

Specifies the qualified name of a secondary exit program for exit point QIBM_QTMF_SVR_LOGON with format TCPL0100.
Exit point QIBM_QTMF_SVR_LOGON with format TCPL0100 may be used by a number of Halcyon products but has a limit of one exit program. Therefore Halcyon uses a primary exit program (HAL_QTMFSL) to call one or more secondary Halcyon exit programs as required. If you have other software that requires use of this exit point, you can arrange for the Halcyon primary exit program to call your exit program by defining your exit program using this system default.
*NONE | No secondary exit program is specified |
Name | Specify the name and library of the exit program to call |
SETEXITPNT PRIMARY(*ENABLE)

Specifies the qualified name of a secondary exit program for exit point QIBM_QTMX_SERVER_REQ with format VLRQ0100.
Exit point QIBM_QTMX_SERVER_REQ with format VLRQ0100 may be used by a number of Halcyon products but has a limit of one exit program. Therefore Halcyon uses a primary exit program (HAL_QTMXSR) to call one or more secondary Halcyon exit programs as required.
If you have other software that requires use of this exit point, you can arrange for the Halcyon primary exit program to call your exit program by defining your exit program using this system default.
*NONE | No secondary exit program is specified |
Name | Specify the name and library of the exit program to call |
SETEXITPNT PRIMARY(*ENABLE)

Specifies the qualified name of a secondary exit program for exit point QIBM_QTOD_SERVER_REQ with format VLRQ0100.
Exit point QIBM_QTOD_SERVER_REQ with format VLRQ0100 may be used by a number of Halcyon products but has a limit of one exit program. Therefore Halcyon uses a primary exit program (HAL_QTODSR) to call one or more secondary Halcyon exit programs as required.
If you have other software that requires use of this exit point, you can arrange for the Halcyon primary exit program to call your exit program by defining your exit program using this system default.
*NONE | No secondary exit program is specified |
Name | Specify the name and library of the exit program to call |
SETEXITPNT PRIMARY(*ENABLE)

Specifies the time interval, in minutes, that the Subsystem Availability Data Collection program waits before performing a scan for active subsystems.

Specifies whether the %Busy column is displayed on the Work with Monitors display.
*NONE | Column is not displayed |
*BUSY | Column displayed shows %Busy figures |
*EVENT | Column displayed shows total events processed by the monitor |

Specifies whether generic web agents are displayed by default upon initial entry to the Work with Monitors display.
*YES | Generic Web Agents are displayed |
*NO | Generic Web Agents are not displayed |

Specifies the maximum number of Auxiliary Network Send Monitors that are run. The actual number varies between this value and the value specified for HAL/SNDMONMIN. The Primary Network Send Monitor may adjust the number of Auxiliary Monitors from time to time in response to the amount and destinations of waiting network messages.

Specifies the minimum number of Auxiliary Network Send Monitors that are run. The actual number varies between this value and the value specified for HAL/SNDMONMAX. The Primary Network Send Monitor may adjust the number of Auxiliary Monitors from time to time in response to the amount and destinations of waiting network messages.

Specifies the host name or IP Address of the default SNMP trap manager. This may be used by the Send SNMP Message (SNDSNMPMSG) command or the SNMP action. If a host name is used, the entry must be defined within either the TCP/IP Host table or via a domain name server. To define the host in the TCP/IP Host Table, use the Add TCP/IP Host Table Entry (ADDTCPHTE) command. To define domain name servers, use the Change TCP/IP Domain (CHGTCPDMN) command.
*LOCAL | The default SNMP trap manager is resident on the local IBM i system |
host or IP | Enter either a host name or an IP Address |

Specifies the first day of the week for reporting purposes. When a report uses *LASTWEEK in the date parameter, this value is used to determine the start day of the week.

Specifies the number days for which Halcyon Daily Statistics are retained.

Specifies the number days for which Halcyon Hourly Statistics are retained.

Specifies the number days for which Halcyon Monthly Statistics are retained.

Specifies the number days for which Halcyon Weekly Statistics are retained.

Specifies the number of days warning that is given for temporary authorization codes that are about to expire. The warning message is sent to the message queue defined in the HAL/ADMINMSGQ system default.
1 to 90 | Specify the number of days |
*NOMSG | No warning messages are issued |

Specifies the display format used by the Work with Rules display.
*STD | The standard display format shows rule number, description and current status |
*TIMES | This format shows rule number, a truncated description, monitoring days and times and the current status |