Auto-start macros

Overview

• Auto-start macros are JavaScript source code files, that are customized or created to meet the specific requirements of user groups or individual users.
• Similar to kernel files, they are automatically loaded when the terminal emulation is started.
• This distinguishes the macros from the templates, which are created according to standards using special editors and, if necessary, selected and loaded by the user.

Depending on the task, the auto-start macros are searched for in the corresponding configuration directories:

• config: default standard configuration
• //CustomData: company-specific custom configuration
• //GroupData/GROUP: individual group configuration
• //UserData/USER: individual user configuration

In the process, different validities are considered:

• Auto-start macros valid for all terminal types are located in the subdirectory /_macro/auto.
  Users cannot define these macros.
• Macros valid for only one terminal type are located in the corresponding subdirectory /TERMINAL/macro/auto
  Example: The auto-start macros for 3270 terminals are located in /3270/macro/auto

Default auto-start macros

The basic default configuration in config contains the following auto-start macros:

• Global configuration for all terminal types:
  • config/_macro/auto/_preferences.js: Settings at startup
  • config/_macro/auto/_colors.js: System colors
  • config/_macro/auto/_hardcopy.js: Hardcopy print
  • config/_macro/auto/_mail.js: Host print or mail
• 5250 terminal settings:
  • config/5250/macro/auto/pco.js: PCO handling

If necessary, you can copy these files to the corresponding configuration directories, and edit them there. Note that your changes are only applied after the cache has been updated!

However, we recommend against modifying the properties in the auto-start files config/TERMINAL/macro/auto/_default.js.

Mail: lwh.mail.cb

The auto-start file config/_macro/auto/_mail.js defines the function lwh.mail.cb. This function is called up every time print data or other documents for the user are ready for retrieval. This data is usually displayed in a separate window of your browser. You can change the program behavior by modifying this function.

Example:

lwh.mail.cb = function(aURL) {

	// display data in a new window
	var hwd = window.open(aURL, "_blank","width=640,height=480,scrollbars=yes,resizable=yes");

	//suppress default action
	return false;
};
...

5250 PCO entry: lwh.pco

For 5250 terminals only:

The auto-start file config/5250/macro/auto/pco.js defines the function lwh.pco. This file is called up whenever the AS/400 host sends a STRPCCMD command to the 5250 terminal in order to trigger a local action on the client computer.
In this file, you can configure the action to be executed. By default, the browser displays the file indicated by the host.

Example:

lwh.pco = function(type, par) {
	// depends on call type
	switch (type) {
		case -2:		// invalid PCO signature
		case -1:		// not STRPCCMD command
			return true;	// accept default handling (skip PCO screen)
		case 0:			// STRPCCMD, wait = true
		case +1:		// STRPCCMD, wait = false
			//return true;	// accept default handling (skip PCO screen)
			break;			// ask user
	}

	// STRPCCMD: show in browser
	var url = par;

	// url details depend on environment
	if (false) {
		// make system specific url from PCO command: 2006-10-04/GB
		url = par[1] + "?dokId=" + par[2] + "&dokPool=" + par[3];
	} else {
		// let user decide about correct url
		var msg = "Received PCO STRPCCMD, wait=" + (type > 0) + ":\n" +
			par.join("\n") +	// show command verbs
			"\nPlease adjust URL (or CANCEL)";
		// suggest url from command verbs
		//url.splice(0, 1);	// remove 1st param ("AS400webstart")
		url = url.join(" ");
		url = window.prompt(msg, url);
	}

	// show adjusted url in browser, if any
	if (url) {
		lw.log2("lwh.pco: start browser with url=" + url);
		window.open(url);
		return true;	// accept default handling (skip PCO screen)
		// skip this screen
		//lwk.send("<ENTER>");
		//return false;
	}

	// accept default handling (skip PCO screen)
	return true;
};
...