Skip to main content

Script files

The connector reads a script file with one or more functions defined in it. The connector refers to functions that you implement in the script by name and executes the appropriate function for each agent operation. You can write custom scripts which must be added in the \<instance>\script\ directory. Official, shipped scripts are included in the agent directory, and use a scripted platform definition file (.con) to call one of the binary agents. The official scripts are designed to work "out of the box", but can be modified to suit your requirements. See Loading a new scripted target system type for information about the scripted platform definition file format.

Caution

Any sample script should be modified to fit your environment and prevent security exploits.

The following sample PSLang scripts are available in the samples directory:

  • Win32 Console Scripts:

    • agtdos-simple.psl

    • agtdos-complete.psl

    These scripts can be used with targets if required to maintain any list of users or groups.

  • Telnet target scripts:

    • agttelnet.psl for Telnet targets that users access with a terminal emulator

    • agttelnet-racf.psl for z/OS targets that users access with a terminal emulator

  • Secure Shell (SSHD Host) target scripts:

    • agtssh-simple.psl is a sample file that is intended to be used as a starting point to build a customized connector - see the PSLang scripts for the Aix, Hpux, Linux and Solaris connectors.