sys application apl-script

sys application apl-script(1) BIG-IP TMSH Manual sys application apl-script(1)



NAME
       apl-script - Provides scripts that can be included by an application
       template.

MODULE
       sys application

SYNTAX
       Configure the apl-script component within the sys application module
       using the syntax in the following sections.

   EDIT
	create apl-script [name]
	modify apl-script [name]
	 options:
	  apl-checksum [[string] | none]
	  apl-signature [[string] | none]
	  description [[string] | none]
	  ignore-verification [true | false]
	edit apl-script [ [ [name] | [glob] | [regex] ] ... ]
	 options:
	  all-properties

   DISPLAY
	list apl-script
	list apl-script [ [ [name] | [glob] | [regex] ] ... ]

   DELETE
	delete apl-script [name]

   GENERATE
       Note: generate cryptographic signature or checksum based on apl script
       text.

	generate sys application apl-script [name]
	  options:
	    checksum
	    signature

DESCRIPTION
       An APL script contains APL that can be directly included into
       application templates.  APL scripts provide a convenient way to build
       libraries of common presentation elements. For detailed description of
       application presentation language elements, See help page of sys
       application template

EXAMPLES
       The following is a fairly simple example of an APL script and a
       template that makes use of the APL script. The APL script defines a
       user type that can then be used multiple times in different templates.

	sys application apl-script com.f5.apl.example {
	    define string port validator "PortNumber"
	}

	sys application template example_template {
	    actions {
		definition {
		    presentation {
			include "com.f5.apl.example"
			section my_section {
			    string address1
			    port portnum1
			    string address2
			    port portnum2
			}
		    }
		}
	    }
	}

       generate my_script checksum

       Generate a checksum for the script text and add the checksum as a
       property.

       generate my_script signature signing-key my_key

       Generate a signature for the script text using the specified private
       key and add the signature as a property.

       Note: For a script which includes a checksum or signature to
       successfully load, the script text contents must match the stored
       checksum or signature.

       To temporarily stop the verification of signature or checksum and still
       retain the checksum or signature, the ignore-verification attribute
       must be set to true. This is done by editing the script and adding the
       ignore-verification attribute.

       To completely clear the signature or checksum, simply set the attribute
       script-signature or script-checksum to empty string "". By doing so,
       the script will be processed as if it was never signed or checksumed.

       modify apl-script my_script {
	   description none
	   script {
	   }
	   ignore-verification true
	   script-checksum 74778e7b13016e0b9329a17f8d2da601
	   total-signing-status checksum
	   verification-status checksum-verified }

OPTIONS
       You can use these options with the apl-script command:

       checksum
	    Generate a checksum for the script text and add the checksum to
	    the script as a property.  Only for use with the generate command.

       description
	    User defined description.

       glob Displays the items that match the glob expression. See help glob
	    for a description of glob expression syntax.

       name Specifies a unique name for the component. This option is required
	    for the commands create and modify.

       regex
	    Displays the items that match the regular expression. The regular
	    expression must be preceded by an at sign (@[regular expression])
	    to indicate that the identifier is a regular expression. See help
	    regex for a description of regular expression syntax.

       script
	    Contains the APL text that can be imported into application
	    templates.

       signature
	    Generate a signature for the script text using the specified
	    private key and add the signature to the script as a property.
	    Only for use with the generate command.

       signing-key
	    The private key to use for signing the script. Only for use with
	    the signature option.

SEE ALSO
       create, delete, edit, glob, list, modify, regex, sys application
       template and generate.

COPYRIGHT
       No part of this program may be reproduced or transmitted in any form or
       by any means, electronic or mechanical, including photocopying,
       recording, or information storage and retrieval systems, for any
       purpose other than the purchaser's personal use, without the express
       written permission of F5 Networks, Inc.

       F5 Networks and BIG-IP (c) Copyright 2010, 2013, 2015-2016. All rights
       reserved.



BIG-IP				  2016-03-14	 sys application apl-script(1)