66 docs tagged with "Reference"

Step-by-step instructions for modifying the Unix Agent configuration file using the LSAM configuration program.

Reference for Unix Agent configuration parameters covering job handling, user impersonation, health monitoring, and privilege settings.

Overview of Agent Configuration Parameters — a reference guide to all Unix Agent lsam.conf parameter groups and their settings.

Reference for Unix Agent environment variables passed to jobs at runtime, including path, job identity, schedule, and file I/O variables.

Reference for Unix Agent-specific exit codes returned when jobs complete, including agent error codes, signal values, and File Arrival job exit codes.

Reference for the required SMA_RM CONFIG section, which sets global parameters such as scan interval, CPU alarm thresholds, user-defined monitor timeouts, and log event behavior.

The SMA_RM configuration file defines the structure and rules for disk, process, and user-defined monitoring sections, including window, log, and comment syntax.

Overview of the SMA FAD Control File, an XML-formatted ASCII configuration file that defines the directories to monitor and the OpCon events to forward to the SAM.

Reference for all supported SMA FAD Control File XML elements, their nesting structure, required versus optional status, valid values, and a complete annotated example.

Reference for the SMA FAD directory layout, including the control, snapshot, and pid subdirectories and their roles in file monitoring and event processing.

Reference for the SMA_RM DISK section, which specifies disk monitoring parameters including name, mount point, usage thresholds, alarm levels, and event variables.

Reference for Unix Agent dispatcher configuration parameters, including the message timeout setting that controls TCP/IP socket behavior when SMANetCom communication is delayed.

Reference for SMA_RM exception-handling specifications, covering event, action, and sleep tags, as well as multi-level alarm processing for disk, process, and user-defined monitors.

Reference for the exit_codes utility, which executes a job and displays its return values, exit code, exit signal, and core image status for debugging purposes.

Reference for the Unix Agent FAD parameter that controls whether the File Activity Detection monitor detects files created while the agent was down.

Reference of all file monitoring capabilities supported by the SMA File Activity Detection Daemon, including file creation, deletion, size change, modification detection, and configurable event timing.

SMAFT supports optional file compression using the UNIX tar and gzip utilities, configurable as PREFERRED or REQUIRED for each agent installation.

SMAFT supports optional file encryption using DES, 3DES, and AES-128 algorithms in ECB and CBC modes, configurable per agent installation as PREFERRED or REQUIRED.

Reference for the file_check utility, which validates that specified files meet existence, access, size, and age criteria before an OpCon job executes.

Guidelines and examples for formatting SMA FAD Control Files, including whitespace handling, comment syntax, and recommended layout for readability.

Reference for the genericpgm utility, a dummy test program that sleeps for a configurable duration and exits with a specified exit code and signal disposition.

Reference for the get_errno utility, which translates a numeric UNIX error code into its symbolic constant and descriptive text for use in job debugging.

Reference for Unix Agent hidden configuration parameters, including lsam_root_directory, check_CRC, and close_SAM_socket, which are only editable directly in the lsam.conf file.

Reference for the install_lsam script, which creates an operational Unix Agent instance with default configuration, a tracking directory, and a properly permissioned control script.

Reference for the install_lsam_service script, which creates symbolic links in the system startup directory so the Unix Agent starts automatically on reboot.

Hardware, software, disk space, memory, and privilege requirements for installing the Unix Agent on a supported UNIX platform.

Reference for OpCon field codes and descriptions returned per job when Unix Agent resource-usage reporting is enabled via the LSAM_job_statistics configuration parameter.

Reference for status messages and job information displayed in Enterprise Manager Operation while Unix Agent jobs are actively running.

Reference for Unix Agent JORS and SMAFT parameters, including settings that control STDOUT and STDERR redirection and Job Output Retrieval System and SMA File Transfer behavior.

Reference for JORS and FTServer error messages recorded in the UNIXLSAM log file, including socket initialization and process spawning failures.

Reference for known defects and limitations in Unix Agent versions, including affected platforms, symptoms, and available workarounds.

Reference for Unix Agent logging configuration parameters, including log file rollover size and maximum archived log file count settings.

Reference for the lsam_killjob command, which forcibly terminates a running OpCon job on the Unix Agent by sending a SIGKILL signal to the identified process.

Overview of Machine Messages.

Reference for the maintain_ofiles utility, which deletes job output files, tracking files, and temporary agent files older than a specified number of days.

Reference for the SMA_RM PROCESS section, which configures process monitoring conditions — including IGNORE, MUST_RUN, MUST_NOT_RUN, and CPU_CHECK — along with alarm levels and event variables.

Reference for redirecting STDOUT output from Unix Agent jobs, including use of the captureSTDOUT script and behavior differences based on the path_to_su parameter.

Overview of Reference.

Reference for the Unix Agent SFTP parameter that configures the port used for SFTP-based file transfer, including fallback behavior to SMAFT.

Reference for the Unix Agent sma_filein parameter that defines the sleep interval between checks of the MSGIN directory.

Reference for the sma_job_step utility, which logs named job steps to the SAM to enable job restart at a specific step from the OpCon Enterprise Manager.

Reference for the sma_LSAM_feedback utility, which sends a message from the Unix Agent to the Detailed Job Messages field in the OpCon Enterprise Manager.

Reference for the sma_ppscript utility, which registers a post-processing analysis script to determine job success or failure after the job's executable finishes.

Reference for the sma_status utility, which sends a short status message from a running job to the OpCon Enterprise Manager to display alongside the job's status.

Reference for STDERR pre-processing error messages written when file transfer job requirements cannot be met before the transfer begins.

Reference for STDERR processing error messages output by FTServer and FTAgent during active file transfer operations, including network, file, and communication errors.

Reference for STDOUT messages output by the Unix Agent FTAgent component during file transfer operations, including backup, transfer result, and completion messages.

SMAFT includes a UNIX-specific feature that preserves the record structure of files transferred from non-UNIX platforms, enabling round-trip transfers with record structure intact.

A reference table of UNIX operating systems and processor architectures supported by the Unix Agent.

Overview of System Modification and Environment Variables.

Reference for Unix Agent TCP/IP configuration parameters, including allowed SMANetCom IP addresses, NIC binding, and TLS certificate settings.

Reference for the XML terminology and nesting structure used in SMA FAD Control Files, including definitions of elements, tags, and parent-child relationships.

Reference for Unix Agent trace option parameters that enable or disable diagnostic tracing for the dispatcher, agent, and other internal processes.

Reference for the uninstall_lsam script, which removes a Unix Agent instance by deleting its output, tracking, and log directories along with its startup and SMAFT scripts.

Complete reference of all Unix Agent control script parameters, including start, stop, status, certificate management, and troubleshooting commands.

Reference catalog of Unix Agent log and error messages, including message IDs, system error codes, and recommended corrective actions.

Version history and change details for the Unix Agent, including new features, improvements, and bug fixes.

Reference for UNIX SMAFT exit codes returned by the Unix Agent and Server during SMA file transfer operations.

Reference for the script formatting rules that OpCon jobs executed by the Unix Agent must follow, including shell invocation, child process handling, and exit codes.

Reference for configuring black list and white list security settings in the Unix Agent to control which users are permitted to run jobs.

Reference for common UNIX system error symbols returned by the Unix Agent, including probable causes and corrective actions for each error condition.

Reference and procedures for reviewing and editing the Unix Agent control script variables, including LSAM_ROOT, SAM_SOCKET, and PATH, after running the install_lsam installation script.

Reference and procedures for reviewing and editing the SMAFT control script variables to ensure they match the Unix Agent control script settings.

Reference for the SMA_RM USER_DEFINED section, which allows custom scripts or programs to report normal/alarm status and return loggable values during each scan cycle.

Overview of the Unix Agent utility programs available in the agent bin directory, covering installation, job management, file checking, and status reporting tools.

Reference for the SMA FAD event string variables and condition variables, including token substitutions for file path, name, and extension, as well as supported file condition types.